Modifying and submitting FMN3INST

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

   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

   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

   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

   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

   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

   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.

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:
   • Change the job card to meet your site's requirements.
   • Change CICSHLQ= to the high level qualifier for your CICS® libraries.
   • Change LEHLQ= to the high level qualifier for your Language Environment® libraries. Remove the reference if Language Environment® is available from LINKLIST.
   • Change CSD= to the data set name of the DFHCSD file.
   • Change FMPROF= to the data set name to be used for the VSAM logon profile data set for FM/CICS.
   • Change FMHLQ= to the high level qualifier for the File Manager target libraries.
   • Change FMPROFD= to refer to your customized version of FMN3PRFD.
   • 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).
   • 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.
   • 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.)
   • If necessary, change RESSEC for the transactions FM or FMVU to RESSEC(YES), if you plan to use CICS® security to protect resources accessed by these transactions.

   Table 1. FM/CICS resource definition names

   Resource name	Description	FMN3POPI change required?
   FMNPROF	File - logon profile data set	Yes
   FM	Transaction - FM/CICS invocation	No
   FMVU	Transaction - verify user ID	Yes
   FMNJ	Transient Data queue name for job submission.	Yes
   FMNM	Transient Data queue for FM/CICS message log.	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.