TIDYPF

Displays saved lists and cataloged items associated with accounts, and optionally removes them for accounts that no longer exist.

Syntax

TIDYPF {account-name} {(options}

Syntax elements

account-nameThe name of a single account. Alternatively, a list of accounts can be supplied from an active select list.

If no account name is supplied, and there is no active select list, the default is to show all saved lists and cataloged items for all non-existent accounts.

Options

L Considers only saved lists.

C Considers only cataloged items.

N Suppresses automatic pagination.

R Removes items when prompted to confirm. This works only if a single non-existent account is specified; otherwise, this option is ignored.

D Does not show any details and does not prompt for confirmation. Each item that is deleted is represented by a dot character. This can only be used in conjunction with the R option.

E Include existing accounts, to produce an output similar to LISTPF. Nothing is removed (the R option is ignored if present).

A Produces an alternative view of the items.

Restrictions

Only available in the SYSMAN account.

Examples

Example 1: Default usage

:TIDYPF

The default command displays all saved lists and cataloged items for accounts that do not exist.

:TIDYPF
Listing possibly abandoned cataloged programs and lists       Page    1

Account ............ Type  Item............. Last Modification .....

DATA-BACKUP          L     LIST-FEB19        05 Mar 2022  04:11:59PM
DATA-BACKUP          L     SAVED-LIST        23 Apr 2022  08:44:12AM
***
TESTACC2018          C     TEST_PROG         25 Feb 2022  02:37:09PM

Example 2: Alternative layout

:TIDYPF (A

An alternative layout is available.

:TIDYPF (A
Listing possibly abandoned cataloged programs and lists       Page    1

Account/Item ..............              Last Modification .....
DATA-BACKUP
  Saved Lists
    LIST-FEB19                           05 Mar 2022  04:11:59PM
    SAVED-LIST                           23 Apr 2022  08:44:12AM
TESTACC2018
  Cataloged Programs
    TEST_PROG                            25 Feb 2022  02:37:09PM

Example 3: Removing abandoned items for a single non-existent account

:TIDYPF TESTACC2022 (RA

Displays the saved lists and cataloged items for the TESTACC2022 account that no longer exists, and allows the items to be removed.

:TIDYPF TESTACC2022 (RA
Listing possibly abandoned cataloged programs and lists       Page    1

Account/Item ..............              Last Modification .....
TESTACC2022
  Cataloged Programs
    TEST_PROG                            25 Feb 2022  02:37:09PM

Do you still want to delete these items (Y/N) ?

Deleted TESTPACC2022_O*C*TEST_PROG from POINTER-FILE

:

Example 4: Listing saved lists in existing accounts

On the majority of systems, multiple users construct lists with the use of SAVE-LIST, COPY-LIST, and so on. These can adversely affect the behaviour of the system by ‘filling’ POINTER-FILE

:TIDYPF TESTACC2023 (LE

This command displays all saved lists within the existing TESTACC2023 account. Any unwanted items may then be removed with DELETE-LIST.

See also

SAVE-LIST, COPY-LIST, DELETE-LIST, DELETE-ACCOUNT.