The SM2R1 program is called with the BS2000 command START-SM2R1. The PL/1 text file and the SM2R1 control file are assigned automatically via link names.
Format
START-SM2R1 |
VERSION = *STD / <product-versionmandatory-man-corr> / <product-version mandatory-man-without-corr> / <product-version without-man-corr> ,MONJV = *NONE / <filename 1..54 without-gen-vers> ,CPU-LIMIT = *JOB-REST / <integer 1..32767> ,MONITOR-FILE-NAME = *BY-LINK-NAME / <filename 1..54 without-gen-vers> ,LIST-FILE-NAME = *BY-LINK-NAME / <filename 1..54 without-gen-vers> ,EVALUATION-FILE-NAME = *BY-LINK-NAME / <filename 1..54 without-gen-vers> |
Operands
VERSION =
Specifies the program version of SM2R1 to be called.
VERSION = *STD
The current program version is called.
VERSION = <product-version>
The specified program version is called.
MONJV =
Specifies the name of the job variable to monitor the SM2R1 run. The job variable must already be cataloged.
MONJV = *NONE
No job variable is specified.
MONJV = <filename 1..54 without-gen-vers>
Specifies the name of an already cataloged job variable.
CPU-LIMIT =
Specifies the CPU time SM2R1 can use during execution. If this time is exceeded in interactive mode, the user is notified by the system; in batch mode, the SM2R1 run is terminated.
CPU-LIMIT = *JOB-REST
There is no time limit for the program.
CPU-LIMIT = <integer 1..32767>
Specifies the CPU time SM2R1 can use during execution.
MONITOR-FILE-NAME = *BY-LINK-NAME
The SM2 output file to be analyzed was assigned by means of the MONDTA file link name.
MONITOR-FILE-NAME = <filename 1..54 without-gen-vers>
Specifies the name of the SM2 output file to be analyzed which is assigned by means of the MONDTA file link name.
LIST-FILE-NAME = *BY-LINK-NAME
The SM2R1 output file was assigned by means of the DIALST file link name.
LIST-FILE-NAME = <filename 1..54 without-gen-vers>
Specifies the name of the SM2R1 output file which is assigned by means of the DIALST file link name.
EVALUATION-FILE-NAME = *BY-LINK-NAME
The SM2R1 transfer file was assigned by means of the EVALDTA file link name.
EVALUATION-FILE-NAME = <filename 1..54 without-gen-vers>
Specifies the name of the SM2R1 transfer file which is assigned by means of the EVALDTA file link name.
The SM2R1 statement END initiates processing, terminating SM2R1 after processing of the statement is completed.
Preparing the program call
Before SM2R1 is called, all the input files have to be specified and the output file which is to incorporate the reports and statistics generated has to be defined. A transfer file for the monitoring data which can be requested as part of a PRINT-REPORTS statement must likewise be assigned prior to the program run.
The input and output files are specified either by means of the corresponding operands of the START-SM2R1 command or by means of file link names assigned with the ADD-FILE-LINK command.
If the output files were not created with CREATE-FILE, they are created implicitly by SM2R1.
The input files are
The SYSDTA system file containing the user’s input statements. SYSDTA can also be assigned to a SAM or ISAM file in addition to SYSCMD.
The SAM output file to be analyzed. The link name to be used is MONDTA.
The SYSDAT.SM2.<ver>.MTFILE control file defining the format of the records in the SM2 output file. The link name to be used is MTFILE (assigned automatically by the START-SM2R1 command).
The PL/1 text file which includes the message texts of the PL/1 runtime system. The link name to be used is TEXTLINK (assigned automatically by the START-SM2R1 command).
The last two files are supplied together with SM2R1.
The user can choose any name for the output file. Its link name is DIALST.
The name for the SM2R1 transfer file is also freely selectable. The link name to be used is EVALDTA.
BUFFER-LENGTH=*STD(SIZE=16) is assigned to the transfer file by default. The user’s own assignments are not changed, but can lead to the program being aborted since the DATA record cannot exceed 32032 bytes in length.
The output file or transfer file need be defined only if it is to be accessed at a later point in time.
Sample command sequence
/ASSIGN-SYSDTA TO=*SYSCMD / <statement file>
/CREATE-FILE FILE-NAME=<outputfile>,SUPPORT=...(SPACE=...)
/CREATE-FILE FILE-NAME=<transferfile>
/START-SM2R1 MONITOR-FILE-NAME=<SAM file of monitored data>,
LIST-FILE-NAME=<outputfile>,
EVALUATION-FILE-NAME=<transferfile>
(SYSDTA statement sequences)
...
//END
/MODIFY-JOB-SWITCHES ON=1 is entered prior to SM2R1 execution, SM2R1 will issue the message *RUNOPT OR *END EXPECTED from the PL/1 runtime system. After input of the PL/1 control statements (*RUNOPT) and (*END), SM2R1 statements can be entered again.Program execution
After the call, SM2R1 displays its version number and the version number of the MTFILE control file and expects statement input. These statements determine:
the period of time for which the SM2 output file is to be analyzed (analysis period)
the degree of detail in which the analysis is to be executed
which variables are to be analyzed
in what form the analyzed data is to be output.
Analysis itself does not begin until the user has sent off his/her statement sequence with an END statement. No more statements can be input after this.
Program, warning and error messages are always output on SYSOUT. SM2R1 also lists all entered statements on SYSOUT if it is running as a batch task or if the input medium is a file.
Program termination / printing the output file
SM2R1 terminates automatically at the end of the analysis process. If output of monitoring data to the output file is requested, the file can be printed with the following command:
/PRINT-DOCUMENT FROM-FILE=outputfile,
DOCUMENT-FORMAT=*TEXT(LINE-SPACING=*BY-EBCDIC-CONTROL)