Verifying the customization of FM/CICS
After you have completed the initial installation and customization of FM/CICS, you can perform the following steps to verify your customization. You might need to refer to the File Manager for z/OS User’s Guide and Reference for CICS.
You verify the installation and customization of FM/CICS by logging on to a CICS® system where you plan to run FM/CICS. Before you can do this, you must have customized FM/CICS, your CICS® system, and, if necessary, TCP/IP.
- Log on to the CICS® system where you have implemented FM/CICS, and enter the FM/CICS transaction, FM.
- Enter your user ID and press Enter.
- The FM/CICS logon panel is displayed:
───────────────────────── File Manager for CICS Logon ───────────────────────── Enter Logon parameters Userid . . . . . . . . USER Password . . . . . . . New Password . . . . . Node . . . . . . . . . FMNODE (Machine the job is to be run on) Procedure. . . . . . . FMC62FM4 (Procedure to run File Manager) Profile data set . . . USER.IPV.IPVPROF Prefix . . . . . . . . USER (Default prefix for data sets) Jobcard //FM&TERM.B JOB (,,,,),&USER, // MSGCLASS=A,MSGLEVEL=(1,1),CLASS=A F1=Help F3=Logoff F4=Reset F5=Wait F6=Default F12=Cancel Enter=Submit
If you specified START=TASK in the parameters in FMN3POPT, or you used (START=TASK) to initiate your FM/CICS session, and a valid port number has been provided, then you will see a logon panel similar to this.───────────────────────── File Manager for CICS Logon ───────────────────────── Enter Logon parameters Userid . . . . . . . . USER Password . . . . . . . New Password . . . . . Profile data set . . . USER.IPV.IPVPROF Prefix . . . . . . . . USER (Default prefix for data sets) Port . . . . . . . . . 2054 Host name F1=Help F3=Logoff F4=Reset F6=Default F12=Cancel
- Enter your password and press Enter.
- Unless using the START=TASK option, the batch job to start the FM/CICS
session will be submitted, and then the FM/CICS Primary Option Menu
should be displayed, as shown in The FM/CICS Primary Option Menu.
- If after submitting the FM/CICS batch job, message FMNCA016 is displayed (Job jobname not
responding), the FM/CICS job may have failed or may be queued. Examine
the job log for further details and possible error messages.
If the job log cannot be found (the FM/CICS job was never started) verify that the FMNRDR DD statement has been properly defined in the CICS® startup JCL and that your system has sufficient initiators. See Updating the CICS startup procedures for further information.
Some of the most common reasons the batch job may have failed or been queued are:- Insufficient authority to access one of the libraries in the FM/CICS procedure. Check the system log for security messages.
- TCP/IP is not active on the CICS® region. Check for TCP/IP error messages in the job log and verify that TCP/IP is active on the CICS® region.
- The CICS® Sockets interface has not been started
- Duplicate job name. Verify if another user may have specified the same job name in the FM/CICS Jobcard input field, or a previous FM/CICS job is still active.
- JCL errors. Check the job log for further information.
Figure 1. The FM/CICS Primary Option Menu Process Options Help ────────────────────────────────────────────────────────────────────────────── FM/CICS Primary Option Menu 0 Settings Set processing options User ID . : XYUSER 1 View View data CICS User : XYC5DFLT 2 Edit Edit data CICS Appl : C62D2FM5 3 Utilities Perform utility functions Date. . . : 2022/10/10 4 Templates Template and copybook utilities Time. . . : 11:32 FM FM File Manager z/OS FI FM/IMS File Manager for IMS z/OS FD FM/Db2 File Manager for Db2 z/OS X Exit Terminate FM/CICS Processing Options: CICS Resource 1 1. File 2. Temporary Storage 3. Transient Data Command ===> F1=Help F3=Exit F4=CRetriev F7=Backward F8=Forward F10=Actions F12=Cancel
Note: The options FM, FI, and FD allow the user to invoke File Manager and FM/IMS from this primary option menu. These options will not appear if you did not customize File Manager Base function security to allow this access. For more information, see Accessing other File Manager functions from the primary option menu. - If after submitting the FM/CICS batch job, message FMNCA016 is displayed (Job jobname not
responding), the FM/CICS job may have failed or may be queued. Examine
the job log for further details and possible error messages.
- Enter VER on the command line to display the release level
and PTF level of FM/CICS and
ADFz Common Components. A panel is displayed similar to this:
IBM File Manager for z/OS Version 15 Release 1 Modification 5 CICS Component (not APF authorized) Service Levels of installed components Base IMS Db2 CICS IPV English -NONE- -NONE- -NONE- -NONE- -NONE-
Notes:- FM/CICS is always shown as
not APF authorized
, even if you have made File Manager APF-authorized, as FM/CICS cannot run APF-authorized. - When you first install FM/CICS,
-NONE-
will be shown under each component that you have installed. Subsequently, when you have applied service to FM/CICS, a PTF number will be shown, indicating the PTF level of each component you have installed. If you have not installed a component, that component will not be shown at all.If you have installed the Japanese language component, another line will be displayed indicating the service level of that component.
- FM/CICS is always shown as
- Press the Exit key (PF3) to exit from the VER display.
- Enter
VERCICS
on the command line to display the level and version of the running File Manager batch job and FM/CICS on all connected CICS® regions. A panel is displayed similar to this:Process Options Help ────────────────────────────────────────────────────────────────────────────── FM/CICS Primary Option Menu CICS Levels IBM File Manager for z/OS Version 15 Release 1 CICS Component Current PTF: -NONE- Level: 1 Connected FM/CICS Levels Sysid Applid Version PTF Level C62D2FM5 V15R1 -NONE- 1 Command ===> Scroll PAGE F1=Help F3=Exit F4=CRetriev F7=Backward F8=Forward F10=Actions F12=Cancel
Notes:- The version, PTF level, and buffer layout level for the running File Manager batch job, and FM/CICS on all interconnected CICS® regions (if the FMN3LVL program is available on those regions), is displayed.
- The level of the File Manager CICS® component and all FM/CICS programs should be the same, otherwise some functions will fail.
- If more than one interconnected CICS® region is displayed, each region should be at the same level as the running FM/CICS batch job. If the level or version is different, these values will be highlighted in red, indicating a possible error.
- A difference in version or level is likely to be due to maintenance not being applied to all instances of FM/CICS, or the FM/CICS programs not being refreshed in the CICS® region after maintenance was applied.
- If FMN3LVL is not available on a
connected system, the text
LOAD ERROR
condition will be displayed. Ensure that FMN3LVL can be loaded on the connected CICS® region and retry the VERCICS command. - If an entry for an interconnected CICS®
region where FM/CICS has been installed is not
displayed in the list, this indicates one of the following:
- An active connection to the region was not acquired when the VERCICS command was issued.
- The FM/CICS program FMN3CICS could not be linked to and loaded on the connected CICS® region.
- A TD queue has been specified for the CONN option in FMN3POPT and the APPLID of the connected CICS® region has not been added to this queue.
Verify that an active connection to the remote region has been acquired and FMN3CICS is available, then retry the VERCICS command.
- Press the Exit key (PF3) to exit from the VERCICS display.
- Press the Exit key (PF3) twice more to exit from FM/CICS.
You can now complete the installation of FM/CICS by performing the ACCEPT processing. The steps involved are described in the File Manager Program Directory.