FRPCFG member of the IMS PROCLIB data set
Use the FRPCFG member of the IMS PROCLIB data set to define the Repository Server (RS) configuration parameters relating to performance, communications, and security. FRPCFG also identifies the names of the RS catalog repository data sets.
When the RS starts, it processes two configuration members: FRPCFG and the BPE configuration member.
You can use any name for the FRPCFG member. The name must be 8 characters long.
Make sure that you specify the same member name in the FRPCFG=member_name parameter in the RS startup JCL.
Environments
The FRPCFG member of the IMS PROCLIB data set is used by the RS address space that is started to manage IMS repositories, such as the IMSRSC repository.
Syntax
You can use the IMS Syntax Checker to modify this member of the IMS PROCLIB data set.
Parameters
- AUDIT=NO | YES
- This keyword is optional. Specifies whether auditing is enabled.
- AUDIT=NO
- Auditing is not enabled. Any other AUDIT LOG parameters that are specified are ignored. This is the default.
- AUDIT=YES
- Enables auditing. If AUDIT=YES, AUDIT_ID and AUDIT_LOG are required.
Y and N are not valid values for this keyword.
- AUDIT_ID=id
- This keyword is required if AUDIT=YES. id is a unique number from 160 to 255 that is placed in the prefix of the log record to identify an audit source. The number is not meaningful. It only identifies audit records that are generated during this RS session so that they can be distinguished from other sources in the log stream.
- AUDIT_FAIL=CONTINUE | ABORT
- This keyword is optional. Determines whether the
RS continues to start or aborts if auditing cannot be established
because the log stream is unavailable. After the RS has started, this
setting determines what happens if a client audit request is unsuccessful.
- CONTINUE
- The client request continues as if the audit request was successful. This is the default.
- ABORT
- The client request fails if the audit record cannot be written.
- AUDIT_LOG=logstreamname
- This keyword is required if AUDIT=YES. The name of the z/OS® log stream to use for the audit records.
- AUDIT_LEVEL=HIGH | NONE
- This keyword is optional. Determines whether audit records are
written to the log. You can change the audit level dynamically by
using the command F reposervername,AUDIT.
- HIGH
- Audit records are written to the log. This is the default.
- NONE
- Audit records are not written to the log.
- AUDIT_DEFAULT=NOAUDIT | SECURITY | UPDATE | READ | SYSTEMREAD
- This is an optional keyword. Determines the default level of auditing
of member access during a client member session. This access level
applies to members of a given repository for which no audit access
rule is set.
- NOAUDIT
- No auditing of member access. This the default.
- SECURITY
- Audit security failures only.
- UPDATE
- Audit member access with update intent.
- READ
- Audit member access with read or update intent.
Under an audit access rule of READ, system read requests do not cause a read audit record to be generated.
- SYSTEMREAD
- Audit member access with system-level read, read, or update intent.
A read request from an authorized client as a part of the update call is identified as a system read request.
Under an audit access rule of SYSTEMREAD, all read requests, including system read requests, are audited.
You can override the value for the AUDIT_DEFAULT parameter by setting the AUDITACCESS parameter in the CSLRIxxx member of the IMS PROCLIB data set.
- IMSPLEX()
- This keyword is optional. Specifies definitions for the IMSplex
for the RS. Only one IMSPLEX keyword can be specified.
- NAME=name
- A 1- to 5-character identifier that specifies the IMSplex group
name. This name defines the IMSplex that the RS will belong to. NAME=
is required and no default exists.
The RS concatenates this identifier to CSL to create the IMSplex group name. All Operations Manager (OM), Resource Manager (RM), Structured Call Interface (SCI), IMS, RS and IMSplex members that are in the same IMSplex sharing group, sharing either databases or message queues, must specify the same identifier. The same identifier must also be used for the IMSPLEX= parameter in the CSLSIxxx, CSLOIxxx, CSLRIxxx, and DFSCGxxx (or DFSDFxxx) members of the IMS PROCLIB data set.
When IMSPLEX() is specified, and when RSNAME= is also specified, the RS address space registers to the local SCI using the value for the repository ID (REPOID) created from the RSNAME parameter as the SCI member name. Specifying IMSPLEX() and RSNAME= allows the RS to be shown in the output of the QUERY IMSPLEX command.Note: Including the RS in the QUERY IMSPLEX output is the only use of SCI made by the RS.If you specify IMSPLEX (), the RS will be included in the QUERY IMSPLEX output; if you do not, it will not. There is no other impact on RS processing, if you specify IMSPLEX().
Both the master RS and subordinate RS register to SCI if IMSPLEX() is specified in their configuration members and their REPOIDs are unique. Only the master RS issues the CSLSCRDY request, indicating to SCI that it is ready to accept work.
IMSPLEX() requires the SCI address space to be available on the same LPAR as the RS address space. If the local SCI is not available, RS retries the register request two more times after the first register request, with a wait of 6 seconds between each request. At the end of the third register request, if SCI is still not available, the RS issues the FRP0003E message and continues processing without registration to SCI. When SCI is started, RS needs to be restarted to be able to register to SCI.
If the RS address space manages repositories in multiple IMSplexes, you must start the SCI of the IMSplex that you want the RS to belong to.
- MAX_COMMUNICATION_RETRY=32 | number
- This keyword is optional. Specifies the number of times a client-side API process retries a failed communication when the failure is due to insufficient z/OS cross-system coupling facility (XCF) threads. If this limit is exceeded, the client request fails with a reason code indicating that the server is busy. By default, 32 communication retries are used. Valid values range from 1 to 255.
- MBR_CORE_MAX=1024 | number
- This keyword is optional. Specifies the maximum amount, in KB, of incore storage allocated to support an XCF data package. If exceeded, a data space is created. By default, 1024 KB of incore storage is used. Valid values range from 64 to 4096.
- PRIMARY_CATALOG_REPOSITORY_INDEX=VSAM_data_set_name
- This is a required keyword. Specifies the name of the primary
repository index data set (RID) of the RS catalog repository. This
name must match the name of the data set in the JCL that you use to
create RS catalog repository data sets.
If the VSAM_data_set_name specified for the parameter extends past column 72 into the next line, and you use the Syntax Checker for the FRPCFG member, the data set name must be enclosed in parentheses () as
PRIMARY_CATALOG_REPOSITORY_INDEX=(VSAM_data_set_name)
. The data set name can be specified entirely on the next line enclosed in parentheses (). If the FRPCFG member is generated by the Syntax Checker, the data set name will be generated in parentheses (). - PRIMARY_CATALOG_REPOSITORY_MEMBER=VSAM_data_set_name
- This is a required keyword. Specifies the name of the primary
repository member data set (RMD) of the RS catalog repository. This
name must match the name of the data set in the JCL that you use to
create RS catalog repository data sets.
If the VSAM_data_set_name specified for the parameter extends past column 72 into the next line, and you use the Syntax Checker for the FRPCFG member, the data set name must be enclosed in parentheses () as
PRIMARY_CATALOG_REPOSITORY_MEMBER=(VSAM_data_set_name)
. The data set name can be specified entirely on the next line enclosed in parentheses (). If the FRPCFG member is generated by the Syntax Checker, the data set name will be generated in parentheses (). - RSNAME=repositoryserver_name
- This keyword is optional. Specifies the 1- to 6-character name for the RS address space. Specify this parameter either as an execution parameter or in the FRPCFG member of the IMS PROCLIB data set.
- SAF_CLASS=saf_class
- This is an optional keyword. Specifies the 1- to
8-character SAF security class name, which is used to implement repository
and member-level security checking.
If this parameter is specified, saf_class must be the name of a defined resource class. If this parameter is omitted, SAF security is not used to restrict access to the RS.
The value must be a left-aligned, 8-byte alphanumeric name with trailing contiguous spaces. The first character must be alphabetic.
- SECONDARY_CATALOG_REPOSITORY_INDEX=VSAM_data_set_name
- This is a required keyword. Specifies the name of the secondary
RID of the RS catalog repository. This name must match the name of
the data set in the JCL that you use to create RS catalog repository data sets.
If the VSAM_data_set_name specified for the parameter extends past column 72 into the next line, and you use the Syntax Checker for the FRPCFG member, the data set name must be enclosed in parentheses () as
SECONDARY_CATALOG_REPOSITORY_INDEX=(VSAM_data_set_name)
. The data set name can be specified entirely on the next line enclosed in parentheses (). If the FRPCFG member is generated by the Syntax Checker, the data set name will be generated in parentheses (). - SECONDARY_CATALOG_REPOSITORY_MEMBER=VSAM_data_set_name
- This is a required keyword. Specifies the name of the secondary
RMD of the RS catalog repository. This name must match the name of
the data set in the JCL that you use to create RS catalog repository data sets.
If the VSAM_data_set_name specified for the parameter extends past column 72 into the next line, and you use the Syntax Checker for the FRPCFG member, the data set name must be enclosed in parentheses () as
SECONDARY_CATALOG_REPOSITORY_MEMBER=(VSAM_data_set_name)
. The data set name can be specified entirely on the next line enclosed in parentheses (). If the FRPCFG member is generated by the Syntax Checker, the data set name will be generated in parentheses (). - VSAM_BUFNO=128 | number
- This keyword is optional. Specifies the number of VSAM buffers in the local shared resource pool used for repository access. All I/O between the RS and the RID and RMD uses a single local shared resource pool. The local shared resource pool is built at server startup using the values of the VSAM_BUFNO and VSAM_BUFSIZE parameters in the RS startup JCL. Valid values range from 3 to 65535. By default, 128 VSAM buffers are used.
- VSAM_BUFSIZE=8 | number
- This keyword is optional. Specifies the size, in KB, of the VSAM LSR pool buffers used for repository I/O. Enter a value from 8 to 32 that is a multiple of 4. The VSAM buffer size must be at least as large as the largest of the control interval sizes of either the RID or RMD components of any repository data set. By default, 8 KB buffers are used. In most cases, 8 KB is the optimal setting for both VSAM_BUFSIZE and the CONTROLINTERVALSIZE parameter in the RS startup JCL.
- XCF_GROUP_NAME=xcfgroupname
- This is a required keyword. The name of the XCF group
that the server joins. Valid characters are A - Z (uppercase only),
0 - 9, and the following symbols: # $ @
The value must be 8 characters padded on the right with blanks. For example, if you provide a value with only 4 characters, you must also include 4 blank spaces to the right of it.
- XCF_THREADS=8 | number
- This keyword is optional. Specifies the number of XCF listener threads available to accept data from clients. Each thread allocates a 32 KB buffer. Valid values range from 4 to 99. By default, 8 XCF threads are used.
Sample FRPCFG member of the IMS PROCLIB data set
#SAF_CLASS=FACILITY
MBR_CORE_MAX=1024
VSAM_BUFNO=64
VSAM_BUFSIZE=8
XCF_GROUP_NAME=FRPSPLEX
XCF_THREADS=4
PRIMARY_CATALOG_REPOSITORY_INDEX=IMSTESTS.REPO.CATPRI.RID
PRIMARY_CATALOG_REPOSITORY_MEMBER=IMSTESTS.REPO.CATPRI.RMD
SECONDARY_CATALOG_REPOSITORY_INDEX=IMSTESTS.REPO.CATSEC.RID
SECONDARY_CATALOG_REPOSITORY_MEMBER=IMSTESTS.REPO.CATSEC.RMD