INQUIRE DELETSHIPPED

Retrieve information about system settings that control the CICS® timeout delete mechanism.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

INQUIRE DELETSHIPPED

hours

minutes

seconds

Conditions: NOTAUTH

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations.

Description

CICS provides a mechanism for deleting shipped terminal definitions after they have been idle for a period of time. The installation specifies how long a terminal must have been inactive to be eligible for deletion (the IDLE time), and how often the check should be made (the INTERVAL). The INQUIRE DELETSHIPPED command displays the current settings of these two control options.

There are two formats for each of the time values that you can retrieve with this command (the idle time and the interval checking period):

A 4-byte packed decimal composite (0hhmmss+), which you obtain by using the IDLE and INTERVAL options.
Separate hours, minutes, and seconds, which you obtain by specifying the IDLEHRS, IDLEMINS, and IDLESECS options (instead of IDLE), and INTERVALHRS, INTERVALMINS, and INTERVALSECS (instead of INTERVAL).

Options

IDLE(data-area): returns the idle time, as a 4-byte packed decimal field in the format 0hhmmss+. Idle time is the minimum time that a terminal must be inactive to be eligible for deletion.
IDLEHRS(data-area): returns the hours component of the idle time, in fullword binary form.
IDLEMINS(data-area): returns the minutes component of the idle time, in fullword binary form.
IDLESECS(data-area): returns the seconds component of the idle time, in fullword binary form.
INTERVAL(data-area): returns a 4-byte packed decimal field, in the format 0hhmmss+, giving the interval at which the check for idle terminals is made.
INTERVALHRS(data-area): returns the hours component of the interval, in fullword binary form.
INTERVALMINS(data-area): returns the minutes component of the interval, in fullword binary form.
INTERVALSECS(data-area): returns the seconds component of the interval, in fullword binary form.

Conditions

NOTAUTH

RESP2 values:

100: The user associated with the issuing task is not authorized to use this command.