M9SAPIJ to execute a policy

Running M9SAPI procedure to execute the policy

Customize the M9SAPI parameters:

Parameter

Details

WAIT

The default is ZOSONLY, meaning that the job will end as soon as z/OS processing ends. Additional values are:

YES - Wait until the policy run ends, including the processing in the management server

NO - End immediately after the policy is scheduled for processing

TOKEN

HOST

The management server IP address or DNS

PORT

The management server port number

INTERVAL

The interval in seconds between activity status checks performed by the M9SAPI procedure

VERBOSE

The messages can be displayed in INFO or DEBUG mode. The default is INFO.

VRFYCERT

The default is YES, meaning that a trusted certificate is defined for the server.

If you wish to use a trusted certificate, see Configure the Remote Server API section in the Installation guide for details. Note that communications between the M9SAPI and the management server are always encrypted, regardless of the VRFYCERT value.

RUNLOG

The default is YES, meaning that the procedure will attempt to retrieve the policy’s run log at the job’s end and write it to the RUNLOG DD:

  • When specifying WAIT=NO, no log will be delivered, no matter what was specified for RUNLOG.

  • When specifying WAIT=ZOSONLY, all log records until that point will be delivered, without the run log’s summary and without any details written later than the job’s end.

  • When specifying WAIT=YES, the full run log will be delivered.

POLICY

The policy name in quotes. This parameter is mutually exclusive with POLICYID.

POLICYID

Can be used when the POLICY name is too long or contains non-MF characters. The POLICYID can be found in the policy’s “More Details” accessed via the 3-dot menu. This parameter is mutually exclusive with POLICY

PAGESIZE

The log page size requested by SAPI with every polling request. Defaults to 10000 lines.

Execute policy example

Last updated