Editing A Member through The J (JCL) Option

Note: You can only perform this function in an ISPF environment.

When specifying option J (JCL) in the Job List screen or the Active Environment screen to edit the JCL member, Control-M must determine which library (MEMLIB or OVERLIB) to use.

The algorithm for this decision depends on:

where the member exists, that is, whether it is only in the MEMLIB library, only in the OVERLIB library, in both libraries, or in neither library)
what CTMIMACx REXX EXECs (if any) are defined
from which screen the J (JCL) option was requested

Table 206 indicates which libraries are used, depending on the above criteria.

Table 206 OVERLIB Parameter: Algorithm for LIbraries Used when Option J (JCL) is Specified

When the following CTMIMAC is defined (if any)...	...the member exists in either library MEMLIB, OVERLIB, both, or neither	...and the screen of the J (JCL) request is: Job List, Active Environment, or either screen	... and the edit is performed in the following library
None (default)	MEMLIB only	Either screen	MEMLIB
	OVERLIB only	Either screen	OVERLIB
	Both	Either screen	OVERLIB
	Neither	Either screen	MEMLIB
CTMIMAC1	MEMLIB only	Job List	MEMLIB
	MEMLIB only	Active Environment	OVERLIB (copied from MEMLIB)
	OVERLIB only	Job List	MEMLIB (open empty member)
	OVERLIB only	Active Environment	OVERLIB
	Both	Job List	MEMLIB
	Both	Active Environment	OVERLIB (not copied)
	Neither	Job List	MEMLIB
	Neither	Active Environment	OVERLIB
CTMIMAC2	MEMLIB only	Either screen	MEMLIB
	OVERLIB only	Either screen	OVERLIB
	Both	Either screen	OVERLIB
	Neither	Either screen	OVERLIB
CTMIMAC3	MEMLIB only	Job List	MEMLIB (But saved only if changed)
	MEMLIB only	Active Environment	OVERLIB
	OVERLIB only	Job List	MEMLIB (open empty member)
	OVERLIB only	Active Environment	OVERLIB
	Both	Job List	MEMLIB
	Both	Active Environment	OVERLIB
	Neither	Job List	MEMLIB
	Neither	Active Environment	OVERLIB

Note the following points:

When using CTMIMAC1 or CTMIMAC2, more than four libraries cannot be concatenated.
When using CTMIMAC3, Exit CTMX014G, in the IOA SAMPEXIT library, is required if libraries are concatenated.
For concatenated libraries, if the &COPYMEM parameter in Exit CTMX014G is set to YES, the saved member is placed in the first library of concatenation. If the &COPYMEM parameter is set to NO, the saved member is placed back in the original JCL library.
The CTMIMACx REXX EXECs can be found in the IOA CLIST library. Instructions for installing these REXX EXECs can be found in comments in the members themselves.
PANVALET and LIBRARIAN considerations when performing online JCL edits:
- For PANVALET or LIBRARIAN support, sample exits CTMX014P or CTMX014L, respectively, must be installed. However, Control-M does not support both products simultaneously.
- When both MEMLIB and OVERLIB exist, and MEMLIB is either PANVALET or LIBRARIAN, the edit function first copies the member to the OVERLIB before performing the edit, unless the member already exists in the OVERLIB.
- IF only MEMLIB exists, and it is LIBARIAN, the edit is performed directly in MEMLIB.
- If the MEMLIB library is PANVALET, editing can only be performed if a non-PANVALET OVERLIB is defined.

Parent Topic

OVERLIB: General Job Parameter