Configuring FOCREPLAY

FOCREPLAY is activated by allocating the DDNAMEs it uses to record, capture, and/or replay a FOCUS session. You can add these allocations to your REXX EXEC, CLIST, or batch JCL that invokes FOCUS.

The required disposition for the FOCREPLAY data sets is DISP=MOD. The recommended DCB attributes are RECFM=VB, LRECL=233472, BLKSIZE=23476 (half track blocking), DSORG=PS. If you want the data sets to be members of a library, you can allocate them as members of a PDSE. Because standard PDS data sets do not support DISP=MOD allocation for their members, you cannot allocate the data sets as members of a PDS. If you want to store them in a PDS, you can allocate them as sequential files and copy them to PDS members after they are complete.

If the DCB attributes differ from the recommended values, they will be changed dynamically during the session. You must have read/write access to all of the FOCREPLAY data sets.

Procedure: How to Activate FOCREPLAY Input Mode

FOCREPLAY records your FOCUS session if you allocate the following two DDNAMEs:

FSC3270I. This DDNAME will contain the script of the session. You can play back this script to rerun the session by allocating the script file as input to replay mode. The 3270 terminal characteristics and session mode (height, width, graphic support, colors, and external attributes) are automatically recorded in this file. This enables you to record sessions for different types of terminals or different modes. Do not edit these lines.
FSC3270O. This DDNAME will contain the captured FOCUS session.

If you allocate an existing file to either DDNAME, the new script and session output are appended to the existing information in the files.

Syntax: How to Issue FILEDEFs for Input Mode on z/VM

FILEDEF FSC3270I DISK script_fileft1fm (DISP MOD
FILEDEF FSC3270O DISK session_outputft2fm (DISP MOD

where:

script_file ft1 fm: Is the filename, filetype, and filemode of the file that will contain the script of the FOCUS session.
session_output ft2 fm: Is the filename, filetype, and filemode of the file that will contain the captured FOCUS session.

Top of page

Example: Sample FILEDEFs for Input Mode on z/VM

FILEDEF FSC3270I DISK FSC3270 IN A (DISP MOD
FILEDEF FSC3270O DISK FSC3270 OUT A (DISP MOD

Syntax: How to Allocate DDNAMEs for Input Mode on z/OS

ALLOC F(FSC3270I) DA('hlq.script.file') MOD
ALLOC F(FSC3270O) DA('hlq.session.output') MOD

where:

hlq.script.file: Is the data set that will contain the script of the FOCUS session.
hlq.session.output: Is the data set that will contain the captured FOCUS session.

Top of page

Example: Allocating DDNAMEs for Input Mode on z/OS

ALLOC F(FSC3270I) DA('USER1.FSC3270I.DATA') MOD
ALLOC F(FSC3270O) DA('USER1.FSC3270O.DATA') MOD

Procedure: How to Activate FOCREPLAY Replay Mode

FOCREPLAY replays your FOCUS session and creates a new output file containing the replayed session if you allocate the following three DDNAMEs:

FSC3270Q. This DDNAME must be allocated to the script of the previously recorded session that you want to play back.
FSC3270O. This DDNAME will contain the replayed FOCUS session. If you allocate the same file that was used when you recorded the session, the played back session will be appended to the recorded session. If you allocate a different output file, the played back session will be in a separate file from the original session.
FSC3270I. This DDNAME should be allocated as DUMMY when replaying a session. If you allocate it to a file, you will both play back the session and record a new input script in the allocated file. This is necessary to use the <RECORD> function described later.

Syntax: How to Issue FILEDEFs for Replay Mode on z/VM

FILEDEF FSC3270Q DISK script_fileft1fm (DISP MOD
FILEDEF FSC3270O DISK session2_outputft2fm (DISP MOD
FILEDEF FSC3270I DUMMY

where:

script_file ft1 fm: Is the filename, filetype, and filemode of the file that contains the script of the previously recorded FOCUS session.
session2_output ft2 fm: Is the filename, filetype, and filemode of the file that will contain the replayed session.

Top of page

Example: Sample FILEDEFs for Replay Mode on z/VM

FILEDEF FSC3270Q DISK FSC3270 IN A (DISP MOD
FILEDEF FSC3270O DISK FSC3270 OUT2 A (DISP MOD
FILEDEF FSC3270I DUMMY

Syntax: How to Allocate DDNAMEs for Replay Mode on z/OS

In a CLIST:

ALLOC F(FSC3270Q) DA('hlq.script.file') MOD
ALLOC F(FSC3270O) DA('hlq.session2.output') MOD
ALLOC (FSC3270I) DUMMY

In a batch job:

//FSC3270Q DD DISP=MOD,DSN=hlq.script.file 
//FSC3270O DD DISP=MOD,DSN=hlq.session2.output 
//FSC3270I DD DUMMY

where:

hlq.script.file: Is the data set that contains the script of the previously recorded FOCUS session.
hlq.session2.output: Is the data set that will contain the replayed session.

Top of page

Example: Allocating DDNAMEs for Replay Mode on z/OS

In a CLIST:

ALLOC F(FSC3270Q) DA('USER1.FSC3270I.DATA') MOD
ALLOC F(FSC3270O) DA('USER1.FSC3270O.DATA2') MOD
ALLOC F(FSC3270I) DUMMY

In a batch job:

//FSC3270Q DD DISP=MOD,DSN=USER1.FSC3270I.DATA
//FSC3270O DD DISP=MOD,DSN=USER1.FSC3270O.DATA2
//FSC3270I DD DUMMY