ASKTIME. IBM iSeries

of mapped commands for the session specified in the SYSID option. The name can be up to 8 characters long. If this option is omitted, a default profile, specified during resource definition, is selected.

STATE(

cvda

)

gets the state of the current conversation. The following CVDA value is returned by CICS if the request is successful:

ALLOCATED

For a complete list of the CVDA values that can be returned on APPC commands and for information about receiving and testing these values, see

“CICS-value data areas (CVDAs)” on page 309.

SYSID(

name

)

specifies the name of an APPC connection to the required system. The name can be up to 4 characters long. This option requests that one of the sessions to the named system is to be allocated.

Exception Conditions

INVREQ

occurs if the ALLOCATE command is not valid for the device to which it is directed.

Default action: Terminate the task abnormally.

SYSBUSY

occurs if no session is immediately available. A previously issued HANDLE

CONDITION(SYSBUSY) command overrides the NOQUEUE option.

Default action: CICS suspends application execution until a session is available.

SYSIDERR

occurs if CICS is unable to provide the application program with a suitable session. That is, if: v The SYSID option specifies a name that is not defined in the terminal control system table (TCS). v

The mode name derived from the PROFILE option is not one of the mode names defined for the APPC system entry. v

All the sessions in the group specified by the SYSID option and the mode name are out of service. v

All sessions to the system specified by the SYSID option are out of service.

Default action: Terminate the task abnormally.

ASKTIME

Request the current date and time of day.

ASKTIME

ABSTIME (

data-area

)

Description

ASKTIME updates the date (EIBDATE) and CICS time-of-day clock (EIBTIME) fields in the EIB. These two fields initially contain the date and time when the task

started. Refer to Appendix A, “EXEC interface block,” on page 529 for details of

the EIB.

326

CICS for iSeries Application Programming Guide V5