FDR Extended MCS Software Console (FDREMCS)
FDREMCS is a program written by BMC Software, Inc. to provide the ability to issue z/OS console commands from a step that uses an Extended MCS (EMCS) software console This program also has some additional special functions.
FDREMCS can issue any z/OS console command (subject to RACF controls).
To execute FDREMCS, the following JCL statements are required:
EXEC statement
The EXEC statement specifies the program name (PGM=FDREMCS). A REGION= parameter is not required.
STEPLIB DD statement
Since FDRPAS is normally installed in a library separate from any other FDR products; a STEPLIB DD statement is usually required, pointing to that library.
SYSPRINT DD statement
Specifies the output message data set. It must be present and is usually a SYSOUT data set, but it may be assigned to DASD or tape.
SYSUDUMP DD statement
Specifies the ABEND dump data set. Usually specifies a SYSOUT data set. Although the SYSUDUMP DD statement is not required, we strongly urge you to always include this DD statement, so that we can help you diagnose error conditions. If you have a debugging aid product on your system that would prevent the desired dump, please add the appropriate one of these statements to the JCL so that a fully-formatted dump is produced.
//ABNLDUMP DD DUMMY Print normal IBM dump in addition to the Abend-AID Report//CAOESTOP DD DUMMY Turn off CAOPTII & CASYMDUMP//DMBENAN DD DUMMY Turn off DumpMaster//ESPYIBM DD DUMMY Turn off Eye-Spy//IDIOFF DD DUMMY Turn off IBM Fault Analyzer//PSPOFF DD DUMMY Turn off Softworks Performance Essential
SYSUT1 DD statement
Specifies a data set to be copied to the SYSUT2 DD. Usually a sequential data set; could be a member of a PDS. Must have RECFM=F or FB and LRECL=80; may have any blocksize that is a multiple of 80.
SYSUT2 DD statement
Specifies a data set to be copied from the SYSUT1 DD. Usually a sequential data set; could be a member of a PDS. FDREMCS sets RECFM=FB and LRECL=80, and sets BLKSIZE=6160 if the block size is not specified.
SYSIN DD statement
Specifies a data set containing the control statements for FDREMCS. Usually a DD * data set. It is required.
FDREMCS control statements
FDREMCS accepts only three control statements: CONSOLE=, TERMINAL=, COMMAND= and SET. Each of the control statements must start on a new line; you cannot put more than one control statement on a line. Comment lines are indicated by an asterisk in column 1.
CONSOLE=
Specifies the name you want assigned to the console, from one to eight alphanumeric characters. Only one CONSOLE= statement may appear.
Default: FDREMCS.
TERMINAL=
Specifies the terminal name assigned to the console, from one to eight alphanumeric characters. Only one TERMINAL= statement may appear. This name is logged on the master console but is not used for anything else.
Default: The value specified for CONSOLE=.
COMMAND=
Specifies a z/OS console command to be issued through the EMCS console. All text after the equal sign through column 71 is used; no quotes are required. The COMMAND= statement may be continued. A continuation is indicated by the last non-blank character in columns 1 through 71 being a comma (,). The continuation begins with the first non-blank character on the next input line. Multiple continuation lines are allowed, but the total length of the command text must not exceed 120 characters.
More than one COMMAND= statement may be input.
SET WAITSUSPEND[,INTERVAL=n][,REPEAT=n]
The SET WAITSUSPEND command reissues the display log command and waits for the suspend message. If message DSNJ372I is not returned, the step abends with U0888.
INTERVAL=n - Specifies the interval (in sec) that the command is reissued.
REPEAT=n - Specifies the number of times the command is reissued.
Console responses
FDREMCS waits up to five seconds after each command has been issued, and displays any responses directed to the EMCS console in that time. This may include responses to the commands that are issued, but may also include other unrelated messages. Responses returned after the five second limit are not displayed. FDREMCS has no way of knowing if the command you specified was completed successfully or had an error.
Sample FDREMCS Job
This example shows how to issue a DISPLAY command.
//DISPLAY EXEC PGM=FDREMCS//STEPLIB DD DISP=SHR,DSN=fdrpas.loadlib//SYSPRINT DD SYSOUT=*//SYSIN DD * CONSOLE=MYCONS COMMAND=DISPLAY SMS/*
The console name MYCONS is optional, but is recommended to be sure that the name does not conflict with other EMCS consoles. As long as the responses to the DISPLAY SMS are returned within five seconds, they are displayed on SYSPRINT.