INQUIRE DELETSHIPPED
Retrieve information about system settings that control the CICS® timeout delete mechanism.
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.