Modifying and submitting FMN3INST and FMN3PRFD

You use the job FMN3INST (and FMN3PRFD) to provide the default job card and other default values that will be used to populate the logon panel the first time the FM/CICS transaction is run for any given user. After a user logs on for the first time the information will be saved in the profile data set for subsequent invocations.

FMN3INST will define the required CICS® table entries, define the FM/CICS profile data set (a VSAM KSDS), and initialize this profile data set with the logon defaults.

The CICS® resources defined by FMN3INST must be defined and installed locally on each CICS® region where the FM/CICS interface will run.

The VSAM data set FMNPROF (#fm.profile.dsn) that is created and loaded by the last two steps of FMN3INST specifies SHAREOPTIONS(2). However, you can share this FMNPROF data set between multiple CICS® systems if you change this to SHAREOPTIONS(4). In this case, you need only run the delete/define and load of the VSAM data set once. An example of how this might be useful is if you use a common DFHCSD data set across more than one CICS® region.

Note: FMNPROF is used to populate the FM/CICS logon panel.
There are three steps to modifying and running FMN3INST:
  • Modify FMN3PRFD
  • Modify FMN3INST
  • Run FMN3INST

FMN3PRFD

You modify FMN3PRFD as follows:

  1. Copy the member FMN3PRFD from FMN.SFMNSAM1 into your own JCL library.
  2. Change the following values in FMN3PRFD in your library, to customize the job card and other logon defaults:
    *JOBCARD only applies to FMN3POPT START=BATCH
    Defines the default job card values.
    You can use up to four lines to provide the job card values. There are two variables you can use:
    • &TERM is substituted with the 1 - 4 character terminal ID when the job is submitted.
    • &USER is substituted with the 1 - 7 character user ID required by FM/CICS when the job is submitted.
    Note:
    1. You can terminate the variable with a period which will be removed during substitution.
    2. You can use these variables to ensure the default job card is unique for each user.
    *PROCNAME=FMN3CICB only applies to FMN3POPT START=BATCH
    The procedure name is the name of the procedure to be used by the submitted batch job. The IBM®-supplied value is FMN3CICB. If you change the name of the procedure then change this statement accordingly. (See Customizing the batch procedure for information about FMN3CICB.)
    *PROFILE=profile_dataset_name applies to both FMN3POPT START=BATCH and START=TASK
    Specifies the default data set name for the user's ADFz Common Components profile data set. This value will be used to populate the profile data set name on the logon panel the first time a user invokes FM/CICS. The user can overwrite the system default on the logon panel. The submitted job will allocate the data set if it does not already exist. If it does exist it must be a partitioned data set with an LRECL of 80. The current user ID will be substituted for the variable &USER referenced in the name.
    Note:
    1. This profile data set is used to store information about the FM/CICS session for the user (similar to an ISPF profile data set).
    2. It is recommended that you define this data set as a PDSE.
    3. This is not the same data set as FMNPROF.
    *USERID=SIGNON applies to both FMN3POPT START=BATCH and START=TASK
    FM/CICS requires a user ID to be provided when you run the transaction. If you specify *USERID=SIGNON then the user ID will default to the CICS® signed on user ID value when a user ID is not provided on transaction invocation. If you remove this statement and you invoke FM/CICS without a user ID then FM/CICS will prompt you for a user ID. If you specify *PASSWORD=REMEMBER or *PASSWORD=PASSTICKET you can remove this statement.
    *PASSWORD=REMEMBER applies to both FMN3POPT START=BATCH and START=TASK
    FM/CICS initially displays a logon panel where you provide user ID and password and other logon information. Specify this statement if you want to bypass the logon panel for subsequent invocations of FM/CICS. FM/CICS will remember your password, and if you sign on to CICS® with the user ID and simply enter the transaction FM, you will bypass the logon panel as long as the logon information recorded by FM/CICS is still valid. To invoke FM/CICS to get the logon panel enter:
    FMuserid
    The logon panel will also appear if the FM/CICS job does not respond to the CICS® region for any reason.
    *PASSWORD=PASSTICKET applies to FMN3POPT START=TASK
    Specify this parameter to direct FM/CICS to request a PassTicket for signed-on users. and, if the PassTicket is successful, bypass the logon panel. See Introduction to CICS security with RACF in the CICS® documentation for more information on generating and using PassTickets for secure sign-on.

FMN3INST

You modify FMN3INST as follows:

  1. Copy the member FMN3INST from FMN.SFMNSAM1 into your own JCL library.
  2. Change FMN3INST in your library as follows:
    1. Change the job card to meet your site's requirements.
    2. Change CICSHLQ= to the high-level qualifier for your CICS® libraries.
    3. Change LEHLQ= to the high-level qualifier for your Language Environment® libraries. Remove the reference if Language Environment® is available from LINKLIST.
    4. Change CSD= to the data set name of the DFHCSD file.
    5. Change FMPROF= to the data set name to be used for the VSAM logon profile data set for FM/CICS.
    6. Change FMHLQ= to the high-level qualifier for the File Manager target libraries.
    7. Change FMPROFD= to refer to your customized version of FMN3PRFD.
    8. If you are supplying FM/CICS with a list of APPLIDs of the connected CICS® regions where FM/CICS is installed, change #fm.conn.list to the data set name that contains the list. A sample list is provided in FMN.SFMNSAM1(FMN3CONN).
    9. Change the SHAREOPTIONS value in the second last step, or remove the last two steps completely, if you are sharing the FMNPROF profile data set. See SHAREOPTIONS for more information.
    10. You can also change the CICS® resource definition names, listed in FM/CICS resource definition names, in the DFHCSDUP step in FMN3INST. Note that changing some of these names also requires a change to the FM/CICS options in FMN3POPI. See FMN3POPI for information about changing FMN3POPI.
    Table 1. FM/CICS resource definition names
    Resource name Description FMN3POPI change required?
    FMNPROF File - logon profile data set Yes
    FMNJ Transient Data queue name for job submission. Yes
    FMNRDR DDNAME for transient data queue FMNJ. No
    FMNC Transient data queue with a list of APPLIDs of connected CICS® regions. Yes
  3. When you have made all the required changes to FMN3INST, submit the job. It should finish with return code zero.