LOCATE FILID

Read syntax diagramSkip visual syntax diagram LOCate FILID SYSTEMuserid**IMG*NLS*NSS*SDF*UCR

Authorization

Privilege Class: C, E

Purpose

Use LOCATE FILID to display the address of a user's spool file identification (FILID) entry.

Operands

SYSTEM
tells CP to locate the FILID entries for all user IDs on your system.
userid
tells CP to locate the FILID entries for the user ID, user ID pattern, or pseudo-user ID (*IMG, *NLS, *NSS, *UCR, or *SDF) specified. For more information on user ID patterns, see Usage Note 1.
*
tells CP to locate the FILID entry for your user ID.
*IMG
tells CP to locate the FILID entry for all printer image library files owned by the system.
*NLS
tells CP to locate the FILID entry for all National Language Support files owned by the system.
*NSS
tells CP to locate the FILID entry for all named saved system files owned by the system.
*SDF
tells CP to locate the FILID entries for all system data files owned by the pseudo-user IDs (*IMG, *NLS, *NSS, and *UCR).
*UCR
tells CP to locate the FILID entry for all user class restructure files owned by the system.

Usage Notes

  1. Pattern matching follows the rules used by the CMS LISTFILE command. Use an asterisk (*) to match any number of characters; use a percent symbol (%) to match any single character. Because there are operands for pseudo-user ID files (*IMG, *NLS, *NSS, *UCR, and *SDF) and because a single asterisk (*) indicates your user ID, there are exceptions to the asterisk rule.

    To specify a pattern that you would normally specify as one of these special cases, use an additional asterisk. For example, specify **NSS to match all user IDs that end with the 3 characters NSS, including the pseudo-user ID *NSS.

Responses

Response 1:

OwnerID  FILID
ID       nnnnnnnn
OwnerID
shows the user ID or pseudo-user ID.
FILID
shows the host logical storage address of the spool file identification entry for that user ID or pseudo-user ID.

Examples

Example 1:

When you enter a LOCATE FILID command with the *SDF operand, you may see something like this:
locate filid *sdf
OwnerID  FILID
*IMG     0764D058
*NLS     0764D0A0
*NSS     0764D034
*UCR     0764D07C
Ready;

Example 2:

When you enter LOCATE FILID *, you may see this:
locate filid *
OwnerID  FILID
EMILY    0764D97C
Ready;

Messages

  • HCP003E Invalid option - command contains extra option(s) starting with option
  • HCP007E Invalid userid - userid
  • HCP020E Userid missing or invalid
  • HCP026E Operand missing or invalid
  • HCP6720I No items found to satisfy selection criteria.