v
An INQUIRE JOURNALNUM NEXT or INQUIRE JOURNALNUM END command is issued, but an INQUIRE JOURNALNUM START command has not been successfully issued.
Default action: Terminate the task abnormally.
INQUIRE PROGRAM
(
name
)
CEDFSTATUS (
cvda
) COBOLTYPE (
cvda
)
EXECUTIONSET (
cvda
)
LENGTH (
data-area
)
HOLDSTATUS (
cvda
)
PROGTYPE (
cvda
)
LANGUAGE (
cvda
)
REMOTENAME (
data-area
)
REMOTESYSTEM (
data-area
) RESCOUNT (
data-area
) STATUS (
cvda
)
TRANSID (
data-area
) USECOUNT (
data-area
)
Condition:
PGMIDERR
The EXEC CICS INQUIRE PROGRAM command retrieves information about a named CICS/400 program or map set definition in the CICS control region.
Options
CEDFSTATUS(cvda)
returns a CVDA value indicating the action of CEDF with this CICS/400 program. CVDA values are:
CEDF
NOCEDF
CEDF works normally when this CICS program is being processed.
CEDF actions, including program initiation and termination, are inhibited when this CICS program is being processed.
COBOLTYPE(cvda)
returns a CVDA value indicating the type of COBOL being used with this
CICS program. CVDA values are:
COBOL
NOTINIT
The CICS program was written in AD/Cycle COBOL/400.
The CICS program is not currently loaded.
NOTAPPLIC
The CICS program was not written in COBOL.
EXECUTIONSET(cvda)
returns a CVDA value indicating whether CICS is to run the CICS program as if it is a linked-to CICS program running in a remote system, and subject to the
CICS API restrictions of a distributed program link (DPL) program. CVDA values are:
DPLSUBSET
The CICS program is restricted, when it runs in the local CICS control region, to the same subset of the CICS API that applies when the CICS program is linked to by a DPL request.
490
CICS for iSeries Application Programming Guide V5
FULLAPI
The CICS program is not restricted to the DPL subset of the
CICS API when it runs in the local CICS control region, and can use the full CICS API.
NOTAPPLIC
The PPT entry defines either a remote program or a BMS map set.
A CICS program is always restricted to the DPL subset when it is invoked in a remote system by a DPL request, regardless of the EXECUTIONSET option.
HOLDSTATUS(cvda)
returns a CVDA value indicating whether a copy of the CICS program is currently loaded with the HOLD option. CVDA values are:
HOLD
NOHOLD
The CICS program copy is currently loaded with the HOLD option.
The CICS program copy is not currently loaded with the
HOLD option.
NOTAPPLIC
The CICS program is not currently loaded.
LANGUAGE(cvda)
returns a CVDA value returns a CVDA value indicating the calling convention specified in the PPT. CVDA values are:
COBOL
C
The COBOL/400 calling convention was specified.
The ILE C calling convention was specified.
LENGTH(data-area)
returns a fullword binary field indicating the length of the CICS program in bytes. A value of 0 is returned if the CICS program is not currently loaded.
PROGRAM(name)
specifies the name of the CICS program or map set as specified in the PGMID parameter within the OS/400 ADDCICSPPT CL command. The name may be up to 8 characters long.
PROGTYPE(cvda)
returns a CVDA value indicating the type of CICS program. CVDA values are:
PROGRAM
The CICS program is a CICS application program.
MAP
The CICS program is a CICS BMS map set.
REMOTENAME(data-area)
returns a 4-character string representing the name that this CICS program has in the remote system.
REMOTESYSTEM(data-area)
returns an 8-character string indicating the name of the remote system, if the
CICS program is remote.
RESCOUNT(data-area)
returns a fullword binary field indicating the number of separate invocations of this CICS program that are taking place at the time of this inquiry.
STATUS(cvda)
returns a CVDA value indicating whether CICS/400 can use the program.
CVDA values are:
ENABLED
The program is available for use.
DISABLED
The program is unavailable for use.
Chapter 33. System programming reference
491
