Keywords and Variables in Direct Commands

ALL
or
A

The name of the object to be processed or a range of names (see also Specifying a Range of Names). Any saved (source) objects and/or cataloged objects are processed.

A8
or
A12

The new name to be given to an object when it is renamed with the RENAME command.

Format/length A12 only applies to debug environments.

The new number to be given to an error message, or the start number of a range of new numbers to be given to a range of existing error messages when using the RENAME command.

The new number to be given to a Predict Set when using the RENAME command.

The name of the cataloged object to be processed or a range of names (see also Specifying a Range of Names).

For rules and DDMs: The corresponding DIC specification can be used instead of CIPHER. If cipher is specified twice, the one specified last will be used.

The source database contains the system file where the object to be processed is stored. The target database contains the system file to which the object is to be copied or moved, or where the object is renamed (or in the case of an error message, renumbered) if relevant.

Valid DBIDs are 1 to 65535.

If no DBID or file number (FNR) is specified and SYSMAIN is called with the system command SYSMAIN or the subprogram MAINUSER (see also Invoking SYSMAIN with Appl. Programming Interface), the following applies: The DBID and FNR of the system file from which SYSMAIN was called are always used. For example: if you enter SYSMAIN from a library contained in the FUSER system file, the DBID and FNR of this file are used.

For rules and DDMs: The corresponding DIC specification can be used instead of DBID. If dbid is specified twice, the one specified last will be used.

DDM
or
VIEW

The name of the DDM to be processed or a range of names. See also Specifying a Range of Names.

DDMDBID
or
DDBID

The DDM database ID (DBID): All DDMs that were cataloged under the specified DBID are processed.

Valid DDM DBIDs are 0 to 65535. If no value or 0 (zero) is specified, the DDM DBID is not checked.

DDMFNR
or
DFNR

The DDM file number (FNR): All DDMs that were cataloged under the specified FNR are processed.

Valid DDM FNRs are 0 to 65535. If no value or 0 (zero) is specified, the DDM FNR is not checked.

The name of the debug environment to be processed or a range of names. See also Specifying a Range of Names.

dbid
fnr
password
cipher

Specifies the environment of the FDIC source and/or target system file: database ID (dbid), file number (fnr), Adabas password (password) and Adabas cipher code (cipher).

For rules and DDMs: DBID, FNR, CIPHER and PASSWORD specifications can be used instead of the corresponding DIC specifications, or vice versa. If an item is specified twice, the one specified last will be used.

DL1
or
SUBFILES
or
S

The name of the DL/I subfile to be processed or a range of names. See also Specifying a Range of Names.

The number of the error message to be processed or the start number of a range of numbers if THRU is specified.

If EXTEND is not specified, a short list of the objects contained in the specified library is displayed. The short list contains the name and the type of the object and indicates whether a source object and/or a cataloged object exists.

If EXTEND is specified, an extended list of the objects contained in the specified library is displayed. In addition to the information displayed if EXTEND is not specified, the extended list provides information from the object directory: programming mode, Natural version, user ID, saved/cataloged date and time, and the source of the object (if any).

FROM
or
FM
or
IN

For profiles, rules, DDMs and DL/I subfiles: Introduces a where-clause.

FMDATE
or
FMDD

The start date of a time period: All objects which were saved or cataloged on or after the specified date are processed.

If no end date is specified with TODATE , all objects from the specified date are selected for processing.

A date must be specified according to the setting of the DTFORM profile parameter (see DTFORM - Date Format in the Parameter Reference documentation) as indicated in the upper right corner of a SYSMAIN menu screen. The default setting is the international format YYYY-MM-DD (YYYY = year, MM = month, DD = day), for example, 2005-08-20.

FMTIME
or
FMTM
or
FMTT

Specifies a start time: All objects which were saved or cataloged at or after the specified time (and date) are processed.

A time must be specified in the format HH:II (HH = hours, II = minutes), for example, 11:33.

The source system file contains the object to be processed. The target system file is the system file to which the object is to be copied or moved, or where the object is renamed (or in the case of an error message, renumbered) if relevant.

Valid FNRs are 1 to 65535.

If no database ID (DBID) or FNR is specified and SYSMAIN is called with the system command SYSMAIN or the subprogram MAINUSER (see also Invoking SYSMAIN with Appl. Programming Interface), the following applies: The DBID and FNR of the system file from which SYSMAIN was called are always used. For example: if you enter SYSMAIN from a library contained in the FUSER system file, the DBID and FNR of this file are used.

For rules and DDMs: The corresponding DIC specification can be used instead of FNR. If fnr is specified twice, the one specified last will be used.

HELP
or
?

You can either include the keyword HELP in the with-clause or enter a question mark (?) as the final character of an object name.

The code of the language of the error message to be processed.

The languages can be specified using any combination of language codes. For information on which language code is assigned to which language, see Language Code Assignments in *LANGUAGE in the System Variables documentation. See also Specifying Languages.

You can use an asterisk (*) to select all existing languages of the error messages to be processed.

LIBRARY
or
APPLIC
or
APL

An optional keyword that indicates the name of a source or a target library. If you omit the keyword and respective value, the library where you logged on before you invoked SYSMAIN is used for processing.

The source library contains the object to be processed. The target library is the library to which the object is to be copied or moved, or where the object is renamed (or in the case of an error message, renumbered).

For system error messages, specify NATURAL-SYSTEM or NATURAL-SYS as lib-name.

lib-name must be specified immediately after the FROM and TO keywords. If the optional keyword LIBRARY is used, it must be entered between FROM or TO and lib-name.

MON
or
NOMON
or
MONOFF

Activates (MON) or deactivates (NOMON or MONOFF) tracing of the current activity in SYSMAIN. During processing, you are informed as to which object is being read, deleted, updated, added, and whether an error occurs. With programming objects, you are also informed about the action taken with the XRef data. This function is effective only with TP environments which can run in non-conversational mode.

PROMPT
or
NOPROMPT

Enables (PROMPT) or disables (NOPROMPT) the SYSMAIN prompts. With NOPROMPT, no confirmation screen is displayed. For example, before any deletion, SYSMAIN prompts you for confirmation.

PASSWORD or
PSW

For rules and DDMs: The corresponding DIC specification can be used instead of PASSWORD. If password is specified twice, the one specified last will be used.

The name of the profile to be processed or a range of names. See also Specifying a Range of Names.

An object with the same name in the target environment is replaced by the object to be processed.

The name of the rule to be processed or a range of names. See also Specifying a Range of Names.

The name of the saved (source) object to be processed or a range of names. See also Specifying a Range of Names.

dbid
fnr
password
cipher

Specifies the environment of the FSEC source and/or target system file: database ID (dbid), file number (fnr), Adabas password (password) and Adabas cipher code (cipher).

Only applies to Predict sets.

The number of the Predict set or the start number of a range of Predict sets which are to be processed.

Only applies to programming objects.

The number of the retained Predict set created with the Predict XRef save set option of the LIST XREF command. You can apply all SYSMAIN processing functions to the objects included in this set.

If any valid number is specified, SYSMAIN assumes a Predict set. If no number is specified, normal object processing is assumed.

Only applies to programming objects.

Activates the option to overwrite the library specification for a Predict set as a part of the security for Predict files.

SETLIBRARY is only evaluated if a valid number has been specified for SETNO.

For programming objects:

Activates the option to overwrite the user ID specification for a Predict set as a part of the security for Predict files.

SETUSER is only evaluated if a valid number has been specified for SETNO.

For Predict sets:

The user ID specification of the Predict sets to be processed. When applied to the source specification, it is used as selection criterion. When applied to the target specification, it is used as new value.

It is not possible to specify ranges.

STOWED
or
BOTH

The name of an object (or a range of names) for which the saved (source) and the cataloged object are to be processed (see also Specifying a Range of Names). Only an object that exists as both a saved object and a cataloged object is processed.

The exceptions to this are copycode, text and recording, neither of which can be cataloged. However, they are included in processing when this option is specified.

number
or
new-number

The end number of a range of error message numbers to be processed if a start number is specified with AS .

A terminal ID: All objects that were saved or cataloged on the specified terminal are processed.

For programming objects, Predict sets, debug environments and error messages:
Specifies a target library.

For profiles, rules, DDMs and DL/I subfiles: Introduces a where-clause.

TODATE
or
TODD

The end date of a time period: All objects which were saved or cataloged on or before the specified date are processed. A start date can be specified with FMDATE .

A date must be specified according to the setting of the DTFORM profile parameter (see DTFORM - Date Format in the Parameter Reference documentation) as indicated in the upper right corner of a SYSMAIN menu screen. The default setting is the international format YYYY-MM-DD (YYYY = year, MM = month, DD = day), for example, 2005-08-20.

Only applies to Predict sets.

The last number of a range of Predict sets which are to be processed.

TOTIME
or
TOTT
or
TOTM

The end time of a time period: All objects which were cataloged or saved at or before the specified time (and date) are processed.

The time must be specified in the format HH:II (HH = hours, II = minutes), for example, 11:33.

USER
or
USR

A user ID: All objects that were saved or cataloged by the specified user are processed.

The where-clause must always follow the FROM or TO keyword and lib-name (if relevant); the sequence of the keywords and values within the clause can be specified in any order.

For details, see the direct command syntax in the object-type specific sections of the SYSMAIN Utility documentation.

The keywords and values of the with-clause can be specified in any order, and the with-clause can be placed in any location within the direct command string, except in the first three positions.

For details, see the direct command syntax in the object-type specific sections of the SYSMAIN Utility documentation.

F
or
N
or
S
or
Y
or
D

Example: AB*
Selected: AB, AB1, ABC, ABEZ
Not selected: AA1, ACB

All items with names greater than or equal to value.

Example: AB>
Selected: AB, AB1, BBB, ZZZZZZZ
Not selected: AA1, AAB

All items with names less than or equal to value.

Example: AX<
Selected: AB, AWW, AX
Not selected: AXA, AY