RSINSCHK

Mainframe Analytics Recorder User Guide

Version
10.1.x
Audience
anonymous
Part Number
MK-92HC226-08
ft:lastEdition
2026-01-30

Function

Checks the following setting items required for setup for incomplete or incorrect information, and then outputs a message showing the check results and the settings:

  • Assigning the READ permission for the profiles defined in the FACILITY class of RACF, to users who execute MAR programs

  • Registering a user SVC

Command type

TSO/E command

Syntax

RSINSCHK[ USERID(user-ID)]

Parameters

USERID(user-ID) ~ <symbolic name consisting of 8 or fewer characters> <<user ID of the user who executes the RSINSCHK command>>

User ID of the user whose permissions are to be checked. Specify the user ID of the following user:

  • For the disk configuration acquisition program, a user who executes the program

    If the same user executes the disk configuration acquisition program and the RSINSCHK command, the USERID parameter can be omitted.

  • For the metric collection program, a user who is assigned to cataloged procedures for startup

To execute the RSINSCHK command with the USERID parameter specified, the READ permission for the STGADMIN.YKA.ERM.INSCHK profile is required.

Return codes

The following table lists and describes the return codes of the RSINSCHK command.

Table. Return codes of the RSINSCHK command

Return codes

Meaning

0

There were no problems with the settings.

8

There were problems with the settings.

24

  • You do not have the permission to specify the USERID parameter.
  • The RSINSCHK command is not registered for APF authorization.

32

A processing error occurred during command execution.

48

The command ended due to an invalid parameter.

Output items

The following table lists and describes the items output when the RSINSCHK command is executed, in the order in which they are output.

Table. Output items of the RSINSCHK command

Output items

Description

Security Settings

  • OK: Permission to execute MAR programs is set.

  • FAULTY: Permission to execute MAR programs is not set.

When the USERID parameter is specified, N/A is output if the READ permission for the STGADMIN.YKA.ERM.INSCHK profile is not assigned to the user who executes the command.

User SVC Routine

  • OK: There are no problems with registration of the user SVC.

  • FAULTY: There are problems with registration of the user SVC.

Facility Class Profiles Query

Name of the profile defined for the FACILITY class#1

Directions

Description about permissions required for executing MAR programs

Version of User SVC for this program

Prerequisite user SVC version for MAR that is currently running

Current User SVC

SVC Number

User SVC number that is currently enabled in the system#2

Version

Version of the user SVC that is currently enabled in the system#2

Dynamic registered User SVC

SVC Number

User SVC number that was dynamically registered by using the RSALCSVC command#2

Version

Version of the user SVC that was dynamically registered by using the RSALCSVC command#2

Static installed User SVC

SVC Number

User SVC number that was statically registered by defining the IEASVCxx parmlib member#2

Version

Version of the user SVC that was statically registered by defining the IEASVCxx parmlib member#2

Directions

Description about the relationship between a user SVC that was dynamically or statically registered and the user SVC enabled in the system

#1

If no value is specified, N/A is output.

#2

If the information cannot be acquired, N/A is output.

Example

The following shows an example of executing the RSINSCHK command.

READY
RSINSCHK USERID(USER01)

Security Settings .........: OK
User SVC Routine ..........: OK

Facility Class Profiles Query    : STGADMIN.YKA.ERM.QUERY

Directions
  The current setup is listed above.
 An unregistered profile is listed as N/A.
  The RACF settings are necessary in order to use JYTMMAIN/JYTCMAIN programs.
 After a profile is defined in the RACF FACILITY class, a user can use
 the programs by being given the access rights of the profile.
  There is the following profile:
   - Facility Class Profiles Query
  To give a user the permissions necessary to use all of the programs:
   1. Make the RACF FACILITY class active.
   2. Define the STGADMIN.YKA.ERM.QUERY profile in the FACILITY class.
   3. Give the user the access rights of the profile.

Version of User SVC for this program .............: vv.r.m-nn(zz) or later
Current User SVC            : SVC Number 200 Version vv.r.m-nn(zz)
Dynamic registered User SVC : SVC Number 200 Version vv.r.m-nn(zz)
Static installed User SVC   : SVC Number 251 Version vv.r.m-nn(zz)

Directions
  The current users SVC routine registration number and version are listed
 above.
 User SVC numbers and versions that have not been acquired are listed as
 N/A.
  If a Dynamic registered User SVC exists, the Dynamic registered User SVC
 will become the Current User SVC.
 If a Dynamic registered User SVC does not exist and a Static installed
 User SVC exists, the Static installed User SVC will become the Current
 User SVC.
 If the Current User SVC is smaller than the Version of User SVC for this
 program, then the program will not run properly.

  If this is the case, use the RSALCSVC command to dynamically register
 the latest User SVC.

  The following is an example of registering a User SVC:
   +--------------------------------------------------------------------+
   : START RSALCSVC                                                     :
   +--------------------------------------------------------------------+
Note:
  A User SVC registered by using the RSALCSVC command will become invalid
 during a re-IPL.
 As a result, we recommend performing either of the following settings
 in order to prepare for the next re-IPL:
   - Add the RSALCSVC command to the COMMNDxx parmlib member, and then
    have the User SVC automatically re-registered during a re-IPL.
   - Define a User SVC in the IEASVCxx parmlib member, and then use the
    User SVC that was statically installed from the next IPL.

 YKK001I RSINSCHK completed. RC=00,V/R=vv.r.m-nn(zz),2015/01/01 00:00:00