ADOPSAI

Purpose

Use the ADOPSAI statement to define the system automation information for an operation.

If you specify this statement, set to Y the USESAI parameter of the corresponding ADOP statement.

Format


1  ADOPSAI?  ACTION (
2.1! ADD
2.1 SETDEFAULT
1 )?  AUTFUNC ('
2.1 automated function
1 ')?  COMMTEXT ('
2.1 command text
1 ')?  COMPINFO ('
2.1 completion information
1 ')?  SECELEM ('
2.1 security element
1 ')

Parameters

ACTION (SETDEFAULT | ADD)
If you specify SETDEFAULT, all the other values that you set in the ADOPSAI statement become the default values for all the ADOPSAI statements that follow. The application description database is not updated. The parameters that you do not set, are assigned their standard defaults.

If you specify ADD or use it by default, the statement can result in an update of the database.

AUTFUNC('automated function')
Alphanumeric name for the automated function field of the operation. It can be up to 8 characters. It must be specified between single quotation marks (see the following examples).
COMMTEXT ('command text')
Free-format name for the command text of the operation. It can include blanks and special characters for a maximum of 255 characters. It must be specified between single quotation marks. This parameter is required.
COMPINFO ('completion information')
The completion information for the operation. It can be up to 64 characters. This parameter is positional. You can specify the following information, in the following order, separated by commas:
  • Maximum wait time, in the format hh:mm:ss.
  • Maximum return code accepted as successful execution.
  • Name of an optional user-supplied completion checking routine It must be contained in single quotation marks.
To delete this information, set COMPINFO to blank.
SECELEM ('security element')
Free-format name for the security element of the operation. It can be up to 8 characters and include blanks and special characters. It must be specified between single quotation marks.

Examples

This example sets the command text and security element for the operation:

ADOP …
ADOPSAI  ACTION(ADD) COMMTEXT('DAILY PAYROLL JOB')
SECELEM('PPPP')

This example removes the completion information set for the operation:

ADOP …
ADOPSAI  ACTION(ADD)
COMMTEXT('DAILY PAYROLL JOB') SECELEM('PPPP') COMPINFO (' ')