NP Select New Files/Library Elements

NP param The FILENAME-SELECT and other fields of the selection mask are filled with the contents of param. Immediately after the NP command has been executed, the file list comprising the selected files is displayed. The transaction step of "filling in the selection mask" is thus skipped.

The selection statements appear in the Command Memory as a single command, and can be displayed on the screen again by pressing Shift ENTER. For explicit entries in the selection mask, this is only valid for the FILENAME-SELECT and USER-ID fields. For firther information, see page 4-, 7-.

param [filename-sel] [; user-id] [; keyw1=...] [; keyw2=...] [...]

Contents with which the selection mask should be filled. The first positional parameter filename-sel will be placed in the FILENAME-SELECT field, the second, user-id, in the USER-ID field. All further parameters are keyword parameters and are entered in the specified fields.

The shortest allowable keyword abbreviation to map to the respective field is shown below:

LA --> LAST PAGE

AG --> AGE

FCB --> FCBTYPE

VOL --> VOLUME

SH --> SHARE / NONSHARE

ACC --> ACCESS

PAS --> PASS

U --> USER OPTION

SO --> SORT OPTION

DOC --> DOCUMENTATION

VAR --> VARIABLE ACTION

The delimiting character ';' can be remapped to another character using the SEP command. For further information, see Chapter 18 "Amending Parameters".

Examples:

NP SRC

All files containing the character string 'SRC' within their name.

NP CFS.,Q

All files beginning with the partial qualification 'CFS.' (Qualified Selection).

NP SRC;XYZ

All files containing the character string 'SRC' under the User-Id $XYZ.

NP SRC;XYZ;AG=0

All files created or amended today (AGE=0), under the User-Id $XYZ, and containg the character string 'SRC' in their name.

NP;US=RETPD>0;VAR=ONX/CAT RETPD=0

All files under the current User-Id whose release date is sometime in the future (USER OPTION :RETPD>0). This NP command also defines a Variable Action to reset the Retention Period (VAR=ONX/CAT RETPD=0). The Variable Action will be executed after the required files are marked (equivalent to the ON command, Action Code X).