LOCATE FILID
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
- 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.