DEFINE command

Where:

name	is the Model 204 name of the entity defined. The name in a data set, link, printer, process, processgroup, punch, or stream definition can be up to 8 characters in length. Field names can be up to 255 characters in length.
LIKE	gives the entity that you are currently defining the attributes of a previously defined entity or template specified by the phrase LIKE previousname. LIKE is not supported for field definitions.
previousname	means the name of the previously defined entity or template. Used by itself, LIKE copies all the attributes of the entity defined by a previous DEFINE command. When used with WITH, the options listed in the WITH phrase override the attributes of the entity specified by the LIKE phrase.
SCOPE=SYSTEM	is required and indicates that the definition is available to all users for the entire run.
options	for the particular forms of the DEFINE command are described in sections that follow. Options must be separated by commas or by one or more blanks.

Syntax notes

Certain rules concerning options are checked at a point later than the time of definition. Refer to the following example:

DEFINE PRINTER P1 WITH - SCOPE=SYSTEM ROUTER=VM - ID=PRIIINTER1

In the example, the correct ID specification PRINTER1 is misspelled. However, the DEFINE command executes. An error occurs if an attempt is made subsequently to execute a USE P1 command that accesses the incorrect DEFINE PRINTER definition.

The example also shows the use of the hyphen (-) as a continuation character. A continuation character preceded by a space is required at the end of an input line, if the command parameters continue onto the next line.

Usage notes

You can create a template and assign it a name with the DEFINE command (except for DEFINE FIELD). The template can contain all the attributes needed to create a new template. You can refer to the template name in a DEFINE command or in an ALLOCATE command where a DEFINE DATASET command previously defined the template. The attributes of a template override those of the previously defined entity.

The definition of any entity can be replaced by entering a DEFINE command, the previously defined entity name, and any attributes to be altered. Issuing a DEFINE command with the same name as one presently in use overrides the current template definition. You, therefore, might unintentionally replace an existing entity definition, because Model 204 does not check if the entity name entered is unique.

When it processes a DEFINE command, Model 204 ends any current User Language update unit and begins a non-backoutable update unit. If a Model 204 command non-back outable update unit is in progress, the DEFINE command is included in that update unit. For more information about Model 204 update units, see the Model 204 File Manager's Guide.

DEFINE commands that contain invalid or mutually exclusive options are rejected by Model 204.