GETITKN

Purpose

The GETITKN command returns the current IPL TOKEN value of the addressed target system LPAR.

Use the GETITKN command if you know the LPAR name or system name and you are interested in the token value to find out if there has been a value change since the last time it was set.

Read syntax diagramSkip visual syntax diagram ISQCCMD target_system_ProcOps_nametarget_system_name.LPAR_name GETITKN

Requirements

The requirements for the GETITKN command to complete successfully are:

  • Processor Operations must be active.
  • The addressed target system or target hardware.lpar must have been initialized using the ISQXIII command.

Parameters

None.

Defaults

None.

Usage

LOAD, SYSTEM RESET, and entering a DISABLED WAIT, all change the value of the IPL TOKEN associated with the LPAR. The token is known to both, the hardware and the operating system. Given that you query the token value directly after a successful LOAD(IPL) and days later the token query returns a different value, you have determined that the lifetime of your initiated IPL ended, maybe earlier than expected by a SYSTEM RESET, DISABLED WAIT or another LOAD (IPL).

Additional Programming Information

On command completion, the immediate HW response report messages are also available in a Pipe KEEP with the name 'ISQ.SNMP'. When using this KEEP as your first Pipe stage, you can directly access this HW data.

Restrictions and Limitations

The GETITKN common command is only supported for SNMP connections. When issuing this request for another ProcOps connection type, it is rejected.

Return Codes

The ISQCCMD command generates the return codes for common command processing.