Add CICS JCT Entry (ADDCICSJCT)

Where allowed to run:

Batch job (*BATCH)
Interactive job (*INTERACT)
Batch program (*BPGM)
Interactive program (*IPGM)
Batch REXX procedure (*BREXX)
Interactive REXX procedure (*IREXX)
Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)

Threadsafe: No

Parameters
Examples
Error messages

Use the Add CICS Journal Control Table (ADDCICSJCT) command to add an entry to the JCT.

When a file is defined in the FCT, you can specify whether or not activity on that file is to be journaled and also specify the id of the journal file. Journal files are identified by a number in the range 1 through 99. In the JCT, you define the characteristics of each journal file.

Parameters

Keyword	Description	Choices	Notes
LIB	Library	Communications name, LIBL, CURLIB	Required, Positional 1
GROUP	Group	Communications name	Required, Positional 2
JFILE	Number	1-99	Required, Positional 3
JRNSTS	Status	ENABLED, DISABLED	Optional, Positional 4
JRNSWT	Automatic switching	YES, NO	Optional, Positional 5
JRNLIB	Journal Library	Name	Optional, Positional 6
RECLMT	Record capacity	1-99999, 1	Optional, Positional 7
NEWJRN	Switch journal at startup	NO, YES	Optional, Positional 8
USRJOB	Submit user job when switched	Name, *NONE	Optional, Positional 9
SBMUSRJOB	Submit user job at shutdown	NO, YES	Optional, Positional 10
JRNFILE	File	Qualified object name	Optional, Positional 11
	Qualifier 1: File	Name
	Qualifier 2: Journal Library	Name, LIBL, CURLIB
JRNMBR	Member	Name, *FIRST	Optional, Positional 12

Library (LIB)

Enter the name of the library that contains the group. Possible values are:

*LIBL: The library list is used to locate the first library that contains the group.
*CURLIB: The current library contains the group. If no current library is specified, the QGPL library is used.
library-name: The name of the library that contains the group.

Group (GROUP)

Enter the name of the group to which this JCT entry is to be added.

group-name: The group name may have a maximum length of 10 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Number (JFILE)

Enter the user journal number. This user journal can also be used for automatic journaling of file activity. The number is also used to identify this JCT entry.

journal: A number in the range 1 through 99.

Status (JRNSTS)

Indicates whether or not the journal number can be used.

Possible values are:

*ENABLED: The journal number can be used.
*DISABLED: The journal number cannot be used.

Automatic switching (JRNSWT)

Indicates whether or not the journal can be switched automatically, when it is full, to the next file generation

Possible values are:

*YES: The journal will be switched automatically when it is full.
*NO: The journal will not be switched automatically when it is full.

Journal Library (JRNLIB)

The IBM i library name that will contain the journal. This field is valid only when the JRNSWT field contains *YES.

Note: The IBM i file name that is used will be generated by the CICS control region. The IBM i file name is composed of the mask: AEGJCnnxxx where nn is the journal number and xxx is the generation number.

library-name: The maximum length is ten characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Record capacity (RECLMT)

The number of records accumulated in order to switch to the next generation of the journal. This field is valid only when the JRNSWT field contains *YES.

Possible values are:

1: The journal is switched once one record is accumulated.
number-of-records-per-file: A number in the range 1 through 99999.

Switch journal at startup (NEWJRN)

Indicates whether or not the journal will be switched to the next generation when the CICS control region is started. This field is valid only when the JRNSWT field contains *YES.

Possible values are:

*NO: Switch only when the journal is full.
*YES: Switch when the CICS control region is started normally and when the journal is full.

Submit user job when switched (USRJOB)

The IBM i program that is submitted via the SBMUSRJOB CL command when the journal is switched. This field is valid only when the JRNSWT field contains *YES.

Note: This IBM i submitted program will not accept any parameters and the program object must exist in the library list associated with the CICS control region.

Possible values are:

*NONE: No IBM i job is submitted when the journal is switched.
job-submit-when-switched: The maximum length is ten characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Submit user job at shutdown (SBMUSRJOB)

Indicates if the IBM i job will be submitted when the CICS control region ends. This is not valid when the USRJOB field contains *NONE.

Possible values are:

*NO: Do not submit the IBM i job when CICS control region ends.
*YES: Submit the IBM i job when CICS control region ends.

File (JRNFILE)

The name of the file that will be utilized by the journal number. This field is valid only when the JRNSWT field contains *NO.

Possible library values are:

*LIBL: The library list for the job that is associated to the CICS control region is used to locate the file.
*CURLIB: The current library for the job that is associated to the CICS control region is used to locate the file. If no library is specified as the current library, the QGPL library is used.
library-name: Specify the name of the library where the file is located.

journal-name: Specify the name of the file.

Member (JRNMBR)

The name of the member in the file that will be utilized by the journal number. This field is valid only when the JRNSWT field contains *NO.

Possible values are:

*FIRST: No file member is specified. The first member in the file is used.
journal-member-name: Specify the name of the file member.

Examples

None

Error messages

Unknown