The OPENFT load module runs either as an ordinary batch job or as a started task. In both cases, the associated user ID must possess the authorizations described in the section “openFT privileges”.
The FJGEN command (see section “Setting openFT installation parameters with FJGEN”) generates JCL statements for loading a batch job and starting the openFT load module. This JCL is entered in the FJBATCH member of the FT procedure library <openft qualifier>.<inst>.CLIST.
Example of the FJBATCH member
//OPENFTF JOB (A123,B123),
// CLASS=A,MSGCLASS=A,
// USER=OPENFT,PASSWORD=OPENFT,
// TIME=1440,REGION=0M
//DLTDMP EXEC PGM=IEFBR14
//DELFILE DD DSN=OPENFTQU.STD.SYSUDUMP.PREV,
// DISP=(MOD,DELETE,DELETE),
// SPACE=(CYL,(20,5)),
// DCB=(DSORG=PS)
//RENAME EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSTSIN DD *
//SYSIN DD *
// ALTER 'OPENFTQU.STD.SYSUDUMP' +
// NEWNAME ('OPENFTQU.STD.SYSUDUMP.PREV')
// IF LASTCC = 8 THEN SET MAXCC = 0
//OPENFT EXEC PGM=OPENFT,TIME=1440,
// PARMDD=FTPARMS
//* openFT V12.1C00 / FJBATCH V121C00
//FTPARMS DD DSNAME=OPENFT.STD.CLIST(FTPARM),
// DISP=(SHR,KEEP)
//STEPLIB DD DSNAME=OPENFT.OPENFT.LOAD,
// DISP=(SHR,KEEP)
//OPENFTS DD DSNAME=OPENFT.OPENFT.NCLOAD,
// DISP=(SHR,KEEP)
//OPENFT DD DSNAME=OPENFTQU.STD.CONN,
// DISP=(SHR,KEEP)
//OPFTATT DD DSNAME=OPENFTQU.STD.OPFTATT,
// DISP=(SHR,KEEP)
//*DDUADS DD DSNAME=SYS1.UADS,
//* DISP=(SHR,KEEP)
//OPFTHSM DD DSNAME=OPENFTQU.STD.COLLECT.DATA,
// DISP=(SHR,KEEP)
//MCDS DD DSNAME=DFHSM.MCDS,DISP=SHR
//SYSIN DD DUMMY
//SYSOUT DD DUMMY
//IEBCOUT DD DUMMY
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD DSN=OPENFTQU.STD.SYSUDUMP,
// SPACE=(CYL,(20,5)),DISP=(,CATLG),
// DCB=(DSORG=PS)
The JCL card for SYS1.UADS has been commented out as it is not required when RACF is used.
The DD cards OPFTHSM and MCDS are required for archiving and retrieving files.
FJGEN creates the FJBATCH member using the specified installation parameters (for further information, see the description of the FJGEN command in section “FJGEN - Set installation parameters”).
You can adapt the JCL statements in this procedure to meet the requirements of your installation.
For example, if a file named SYS1.UADS exists on your system whereas validation of the user ID is to be performed via RACF then you must remove the two lines with the assignment of DDUADS to SYS1.UADS from the procedure.
In the statement //OPENFT EXEC PGM=OPENFT, ... you can replace the program name OPENFT with the aliases OPENFTS or OPENFTSL described in section “Installing from CD”, see also section “openFT product files”.
If a local host name other than the default has been specified for the openFT instance in FJGEN then this is entered after the port number in the PARM parameter of the
//OPENFT ... statement.
You can redirect the openFT job log to a file by modifying the DD statement with the label SYSPRINT. Attention must be paid to the following factors:
Output can be directed into a PS data set or into a PO or PDSE member. However, an existing PO or PDSE member cannot be extended.
If the file is to be newly created, do not make any specifications concerning the record length (LRECL) and the block size (BLKSIZE). openFT generates the file with LRECL=1536 and BLKSIZE=1536.
If you are using an existing file (i.e. if you are extending a PS data set or if you are creating a new member in an existing PO or PDSE data set), the file must have the attributes LRECL=512 and BLKSIZE=512.
Examples
If the PS data set does not yet exist, it is to be created; otherwise it is to be extended:
//SYSPRINT DD DSN=USERID.LOG1,DISP=(MOD,CATLG),RECFM=FB,// SPACE=(CYL,(20,20))An existing PS data set is to be overwritten:
//SYSPRINT DD DSN=USERID.LOG2,DISP=(OLD)The PO or PDSE data set already exists. If the member does not yet exist, it is to be created; otherwise it is to be overwritten:
//SYSPRINT DD DSN=USERID.LOG3(MEMBER1),DISP=(OLD)
The DD statement with the label SYSUDUMP causes openFT to write the dump to this file in printable form on a "Cancel with Dump". Other system dumps are output to SYSFDF.
If openFT is to run as a started task, which means that it is to be started either automatically when the system starts or by means of an operator command, a specific start procedure must be created by the user's computer center. The FJBATCH created with the FJGEN can be used as a template to be copied.
Example of a start procedure:
// PROC
//DLTDMP EXEC PGM=IEFBR14
//DELFILE DD DSN=OPENFTQU.STD.SYSUDUMP.PREV,
// DISP=(MOD,DELETE,DELETE),
// SPACE=(CYL,(20,5)),
// DCB=(DSORG=PS)
//RENAME EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSTSIN DD *
//SYSIN DD *
// ALTER 'OPENFTQU.STD.SYSUDUMP' +
// NEWNAME ('OPENFTQU.STD.SYSUDUMP.PREV')
// IF LASTCC = 8 THEN SET MAXCC = 0
//OPENFT EXEC PGM=OPENFT,TIME=1440,
// PARMDD=FTPARMS
//* openFT V12.1C00 / FJBATCH V121C00
//FTPARMS DD DSNAME=OPENFT.STD.CLIST(FTPARM),
// DISP=(SHR,KEEP)
//STEPLIB DD DSNAME=OPENFT.OPENFT.LOAD,
// DISP=(SHR,KEEP)
//OPENFTS DD DSNAME=OPENFT.OPENFT.NCLOAD,
// DISP=(SHR,KEEP)
//OPENFT DD DSNAME=OPENFTQU.STD.CONN,
// DISP=(SHR,KEEP)
//OPFTATT DD DSNAME=OPENFTQU.STD.OPFTATT,
// DISP=(SHR,KEEP)
//OPFTHSM DD DSNAME=OPENFTQU.STD.COLLECT.DATA,
// DISP=(SHR,KEEP)
//MCDS DD DSNAME=DFHSM.MCDS,DISP=SHR
//SYSIN DD DUMMY
//SYSOUT DD DUMMY
//IEBCOUT DD DUMMY
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD DSN=OPENFTQU.STD.SYSUDUMP,
// SPACE=(CYL,(20,5)),DISP=(,CATLG),
// DCB=(DSORG=PS)
The installation parameters described in the section the FJGEN command
(see FJGEN - Set installation parameters) must also be used in this start procedure.
The explanations given above for adapting the FJBATCH member (program name OPENFT, SYSPRINT, SYSUDUMP) also apply here.