Managing Environments in Batch › Define Statements

Define Statements

Use DEFINE statements to create or update environment definitions. An environment definition is created if it does not exist. An update occurs if the environment definition exists.

The following general conventions apply to all DEFINE statements:

• Names you specify in the DEFINE clause can have a maximum of 8 characters with the exception of SHIPMENT DESTINATION, which can be no longer than 7 characters, and APPROVER GROUP, which can be no longer than 16 characters.
• You can use partially or fully wildcarded names in DEFINE clauses. Wildcarded names indicate that an update is to be performed on existing environment definitions that match the name you specify.
• You cannot specify names that include imbedded spaces, non-alphabetical, non-numeric, or non-national characters. However, this does not fully apply to the PROCESSOR OUTPUT TYPE, which can contain any characters or imbedded spaces, but cannot start with a leading blank.
• Updating an inventory definition does not change settings that are not specified in the Define statement used to update the inventory definition. For example, after the first DEFINE statement creates the inventory definition, the second DEFINE statement only updates the settings specified in the second DEFINE statement. Any settings not specified in the second DEFINE statement are not changed.
• Variable values can be enclosed in double or single quotes, but quotes are not required, except for data set names. All variable values on Define statements created by Build statements are enclosed in quotes by default.