IISYSPRINT DO SYSOUT=A - STCPOST OS/VS JOB CONTROL LANGUAGE

STCPOST OS/VS JOB CONTROL LANGUAGE

3 IISYSPRINT DO SYSOUT=A

4 IISYSCClIB DO DSN=data-set-name,OISP=SHR 5 IISYSCCDEF DO DSN=data-set-name,OISP=SHR 6 Ilddname DO ^[ a test device DO card

7 IISYSIN DO *

8 [ STCPOST control cards ]

9 II

Following is a description of each card in' the example job.

1. The JOB card is installation dependent.

2. The EXEC card requests that the program STCPOST be executed.

If the PARM parameter is included, it must be specified as described in the section titled: Temporarily Changing

STCPOST Execution Parameters in Chapter 4. If the parameter field specifies a control card set name or number or *, the SYSCCLIB DO and SYSCCDEF DO cards must be included.

3. The SYSPRINT DO card describes the printed output file.

4. The SYSCCLIB DO card describes the control card data set of the Control Card Editor. the Control Card Editor is not

OS/VS JCL

5. The SYSCCDEF DO card describes the default control card data set of the Control Card Editor. If the Control Card Editor is not used, omit this card and the SYSCCLIB DO card.

6. One or more test device DO cards are used to describe each of the devices to be tested. Refer to the section titled Test Device DO Card in this chapter.

7. The SYSIN DO card describes the control card input file. If this DO card is omitted, STCPOST will invoke the Control Card Editor.

8. One or more control cards are used to specify the STCPOST functions which are to be executed. If the SYSIN DO card is omitted, do not include any control cards.

9. This card indicates the end of the job JCL deck.

TEST DEVICE DD CARD

The test device DO card(s) define to STCPOST the device(s) that are to be tested. One test device DO card must be included for each device that STCPOST is to test. There are seven types of

test device DO cards. The type used is determined by the function being executed.

The following terms are used in the DO card type descriptions.

ddname disk

tape

printer

6-2

=

the DO card name. See the OPTION function DONAME param-eter.

=

the disk drive device type: 3330 (model 1), 3330-1 (model 11), 3350, 3380 or 2305-2. The device address can also be used (three hex digits).

=

the tape drive device type: 3400-4 (800/1600 bpi) or 3400-6 (1600/6250 bpi). The device address can also be used (three hex digits).

=

the printer device type:

1403 - MOD II (IBM 1403-N1) 3203 - MOD VII (IBM 3203-5) 3211 - MOD I (IBM 3211)

3800 - 6100 Laser Printer (IBM 3800)

The device address (three hex digit) can also be used.

FE-001-4

OS/VS JCL

volser = the volume serial number of the disk volume or tape volume to be mounted on the test device.

nt = the number of tracks to be allocated.

nc = the number of cylinders to be allocated.

loc = the address of the first track to be allocated. The address is calculated using this formula (all numbers are decimal): loc = ( (cyl numb) x (numb trks per cyl)

+ (head numb) ). Cylinder zero head zero is track location zero.

NOTE

For DO card types 3, 4, and 6, the UNIT and VOL parame-ters are required only if the existing data set is not cataloged.

DO CARD TYPE 0

DO type

°

is used by the FORMAT, MODECHG, and RECREATVL func-t ions.

This DO type must be defined to STCPOST via the DEFINE function.

There is no DO card in the OS/VS job JCL for STCPOST. The device must be offline to the OS/VS operating system when STCPOST is executed.

DD CARD TYPE 1

This card is used for disk read-only functions. The format of a type 1 DO card is:

//ddname DO UNIT=disk,VOL=SER=volser,SPACE=(TRK,O) DO CARD TYPE 2

This card is used for disk write functions. The format of a type 2 DO card is:

(TRK,nt, ,CONTIG) //ddname DO UNIT=disK,VOL=SER=volser,SPACE=(CYL,nc, ,CONTIG) (ABSTR, (nt, loe))

OS/VS JCl

po CARD TYPE 3

This card is used for disk write functions within the existing data set STC.WRITE.READ. The format of a type 3 DO card is:

//ddname DD DSN=STC.WRITE.READ,DISP=OLD[,UNIT=disk,VOL=SER=volser]

This data set MUST be a standard OS/VS allocated data set. It can NOT be a VSAM data set allocated by the VSAM Access Method Services program (AMS). When using this data set name,

'STC.WRITE.READ', STCPOST checks only the first 14 characters.

For example:

DSN=STC.WRITE.READ

DSN=STC.WRITE.READ.0001 DSN=STC.WRITE.READ.TEST.

DO CARD TYPE 4

This card is used for disk write functions within the existing data set STC.DEFECT.TRACK. The format of a type 4 DO card is:

//ddname DD DSN=STC.DEFECT.TRACK,DISP=OLD[,UNIT=disk,VOL=SER=volser]

This data set MUST be a standard OS/VS allocated data set. It can NOT be a VSAM data set allocated by the VSAM Access Method Services program (AMS). When using this data set name,

'STC.DEFECT.TRACK', STCPOST checks only the first 16 characters.

DO CARD TYPE 5

This card is used for tape or printer functions. The format of a type 5 DO card is:

Ilddname DO UNIT=tape,VOL=SER=volser,LABEL=(,BLP) or

/Iddname DO UNIT=printer DD CARD TYPE 6

This card is used for disk read functions within any previously defined data set. The Display function uses a type 6 DO card.

The format of a type 6 DO card is:

//ddname DO DSN=data-set-name,DISP=OLD[,UNIT=disk,VOL=SER=volser]

6-4 FE-001-4

OS/VS JCL

//ddname DO DSN=data-set-name,DISP=SHR[ ,UNIT=disk,VOL=SER=volser]

TESTING OFFLINE DEVICES

Offline devices tested by STCPOST must be defined via the DEFINE function. There is no DO card in the the OS/VS job JCL for any device defined via the DEFINE function. Testing of offline

devices may be mixed with testing of online devices in the same STCPOST job. The device tested must be offline to the operating system. At least one physical path to the device must be enabled and varied online when STCPOST begins execution. See the descrip-tion of the DEFINE funcdescrip-tion in Chapter 10.

THE STCPOST OS/VS JCL PROCEDURE

The STCPOST OS/VS JCL procedure can be executed by either a batch job, or by using the OS/VS START command. When this procedure is used, the Control Card Editor is always invoked. If the TEST

parameter is coded on the START command or on the EXEC card, the Control Card Editor will supply the specified control card set.

If the TEST parameter is not coded, the Control Card Editor will allow the control cards to be defined at the operator's console.

STCPOST OS/VS JCL PROCEDURE PARAMETERS

The STCPOST OS/VS JCL procedure has several parameters which are used to specify the test device, test volume, test data set name, etc. Each of the parameters is described below.

TEST PARAMETER

The TEST parameter specifies the control card set name or number that the Control Card Editor will supply. If this parameter is not specified, the Control Card Editor will allow the control cards to be defined at the operator's console. Refer to Chapter 9, The Control Card Editor.

U PARAMETER

The U parameter specifies the device type of the test device.

Valid disk device types are: 3330 (3330 model 1), 3330-1 (3330 model 11), 3350, 3380 and 2305-2. Valid tape device types are:

3400-4 and 3400-6. Valid printer device types are 1403, 3203, 3211, and 3800. The device address (three hexadecimal digits) can also be used. The default for this parameter is 3350.

OS/VS ~CL

V PARAMETER

The V parameter specifies the volume serial number of the volume mounted (or to be mounted) on the device which is to be tested.

The default for this parameter is VVVVVV.

OS PARAMETER

The OS parameter specifies the data set name for the test data set. This name must be either 'STC.WRITE.READ' or

'STC.DEFECT.TRACK'. The default for this parameter is &&POST (a temporary data set).

D1 PARAMETER

The 01 parameter specifies the disposition (status) of the test data set at the beginning of the STCPOST execution. The

disposi-tion is either NEW or OLD. If the test device is a DASD and the disposition is NEW, a test data set is allocated (created). If the test device is a DASD and the disposition is OLD, the data set name specified by the OS parameter must be either

STC.WRITE.READ ... (for a type 3 DO), STC.DEFECT.TRACK ... (for a type 4 DO) or 'anyname' (for a type 6 DO) and must be on the vol-ume specified by the V parameter. If the test device is a tape device, the disposition can be either NEW or OLD. The default for this parameter is NEW.

02 PARAMETER

The 02 parameter specifies the dispostion of the test data set at the end of STCPOST execution. The disposition is either KEEP or DELETE. If the test device is a DASD and the disposition is DELETE, the test data set is deleted (scratched). If the test device is a DASD and the disposition is KEEP, the data set will be kept. If the test device is a tape device, the disposition can be either DELETE or KEEP. The default for this parameter is DELETE.

T PARAMETER

The T parameter specifies the type of DASD space to be allocated if the test device is DASD and 'D1=NEW' is specified. CYL speci-fies the space is to be allocated in cylinders; TRK specispeci-fies the space is to be allocated in tracks; ABSTR (absolute track) speci-fies that a specific track address is to be allocated if avail-able. See the S parameter below. The default for this parameter

is CYL.

6-6 FE-001-4

OS/VS JCL

S PARAMETER

The 5 parameter specifies the amount of DASD space to be allo-cated if the test device is DASD and D1=NEW is specified. The T and 5 parameters are related as follows:

T Parameter S Parameter

CYL The number of cyls to allocate in the format S=n TRK The number of trks to allocate in the format S=n ABSTR The number of tracks to allocate (amt) and the location (loc) of the first track in the format S='amt,loc'. 10c is calculated using this formula (all numbers are decimal):

10c = ((cy1 number) x (number of tracks per cyl)

+ (head number)). For example: cylinder 25 head 3 on a 3350 type device is track 1 oca t ; on 753, (( 2 5) x (30) + (3)).

LBL PARAMETER

The LBL parameter specifies the type of label on a tape volume if the test device is a tape device. For DO type 5, this parameter should be either LBL=NL or LBL=BLP. LBL=SL must not be used

because STCPOST will not use a standard labeled tape volume. For DO type 6, NL, BLP, or SL can be used.

USING THE OS/VS JCL PROCEDURE IN A BATCH JOB

The following JCL can be used to execute the OS/VS JCL Procedure in a batch job:

1 //jobname JOB acct-info,name, .. .

2 // EXEC PROC=STCPOST, .. . [ see below ] 3 1/

Following is a description of each card in the example job.

1. The JOB card is installation dependent.

OS/VS JCL

2. The EXEC card requests that the STCPOST OS/VS JCL procedure be executed. Additional parameters on the EXEC card specify

the DO card type to be used for the test device.

3. This card indicates the end of the job JCL deck.

The test device DO card type is specified by additional parame-ters on card 2 of the JCL deck. The following shows the format of card 2 for each of the DO card types:

Using DO card type 1:

II EXEC PROC=STCPOST,U=disk,V=volser,S=O[,TEST=x]

Using DO card type 2:

II EXEC PROC=STCPOST,U=disk,V=volser,S=nc[,TEST=x]

Using DO card type 3:

II EXEC PROC=STCPOST,U=disk,V=volser,

II D1=OLO,02=KEEP,DS=' STC.WRITE.READ' [,TEST=x]

Using DO card type 4:

II EXEC PROC=STCPOST,U=disk,V=volser,

II

D1=OLD,D2=KEEP,DS='STC.DEFECT.TRACK' [,TEST=x]

Using DO card type 5:

II

EXEC PROC=STCPOST,U=tape,V=volser[,TEST=xl or

II

EXEC PROC=STCPOST,U=printer[,TEST=x]

6-8 FE-001-4

OS/VS JCl

NOTE

1. This job requires that the STCPOST OS/VS JCL pro-cedure be installed in SYS1.PROCLIB or a similar procedures library.

2. The MODECHG, FORMAT and RECREATEVL functions which use DO card type 0 can not be used with this job.

3. Only one test device can be operated during the execution of this job.

4. See the Basic OS/VS JCL section for the descrip-tions of disk, tape, etc.

5. See the STCPOST OS/VS JCL Procedure Parameters section for a description of the TEST parameter.

STARTING THE PROCEDURE AT THE OPERATOR' 5 CONSOLE

The following START commands can be used to start the OS/VS JCL Procedure at an OS/VS system console.

Using DO card type 1:

S STCPOST,U=disk,V=volser,S=O[,TEST=x]

Using DO card type 2:

S STCPOST,U=disk,V=volser,S=nc[,TEST=x]

Using DO card type 3:

S STCPOST,U=disk,V=volser,D1=OLD,02=KEEP, DS=' STC. WRI TE. READ' [ , TEST=x]

Using DO card type 4:

5 STCPOST,U=disk,V=volser,D1=OLD,D2=KEEP, OS=' STC. DEFECT. TRACK' [ , TEST=x]

Using DO card type 5:

5 STCPOST,U=tape,V=volser[,TEST=x]

SSTCPOST,U=printer[,TEST=x]

OS/VS JCl

NOTE

1. These OS/VS operator START commands require that the STCPOST OS/VS JCL procedure be installed in SYS1.PROCLIB or a similar procedures library.

2. OS/VS1 operating systems require that the parti-tion number be specified after STCPOST, i.e. 'S STCPOST.Pn, ... ,' where n is the partition number.

3. If the OS parameter is specified, the data set name must be entered in upper case.

4. The MODECHG, FORMAT and RECREATEVL functions which use DD card type 0 can not be used with the START conmand.

5. Only one test device can be operated during the execution of the job started with the START com-mand.

6. See the Basic OS/VS JCL section for the descrip-tions of disk, tape, etc.

7. See the STCPOST OS/VS JCL Procedure Parameters section for the description of the TEST parameter.

THE STCPOSTD OS/VS JCL PROCEDURE

The STCPOSTD OS/VS JCL procedure is .used to a lloca te the LOGREC data set so that the STCPOST DISPLAY function can be executed.

This procedure should not be used if any other STCPOST function is to be executed.

The defaults for the parameters of this procedure should be

changed to the unit type, volume serial number, and data set name of-the LOGREC data set for the system that this procedure is

installed on.

The STCPOSTD procedure can be executed by either a batch job, or by using the OS/VS START command. When this procedure is used,

the Control Card Editor is always invoked. If the TEST parameter is coded on the START command or on the EXEC card, the Control Card Editor will supply the specified control card set. If the TEST parameter is not coded, the Control Card Editor will allow the control cards to be defined at the operator's console.

6-10 FE-001-4

OS/VS del

STCPOSTD OS/VS JCL PROCEDURE PARAMETERS

The STCPOSTO OS/VS JCL procedure has several parameters which are used to specify the device type, volume serial number, and data

set name for the

LOGREe data set. Each of the parameters is described below.

U PARAMETER

The U parameter specifies the device type of the LOGREC data set volume. Valid disk device types are: 3330 (3330 model 1), 3330-1

(3330 model 11), 3350, 3380 and 2305-2. The device address

(three hexadecimal digits) can also be used. The default for this parameter is 3350.

V·PARAMETER

The V parameter specifies the volume serial number of the LOGREC data set volume. The default for this parameter is VVVVVV.

OS PARAMETER

The OS parameter specifies the data set name for the LOGREC data set. The default for this parameter is SYS1.LOGREC.

TEST PARAMETER

USING THE STCPOSTD PROCEDURE IN A BATCH JOB

The following JCL is used to execute the STCPOSTD Procedure in a batch job.

1 Iljobname JOB acct-info,name, ...

2 II EXEC PROC=STCPOSTD,... [ see below ] 3 II

Following is a description of each card in the example job.

1. The JOB card is installation dependent.

OS/VS JCL

2. The EXEC card requests that the STCPOSTD OS/VS JCL procedure be executed. Additional parameters on the EXEC card define

the device type, volume serial number, and data set name for the LOGREe data set.

3. This card indicates the end of the job JCL deck.

The LOGREC data set is specified by additional parameters on card 2 of the JCL deck. The following example shows the format of card 2:

II EXEC PROC=STCPOSTD,U=disk,V=volser[ ,DS='dsname' [,TEST=x]]

NOTE

1. This job requires that the STCPOSTD OS/VS JCL pro-cedure be installed in SYS1.PROCLIB or a similar procedures library.

2. See the Basic OS/VS JCL section for the descrip-tions of disk, tape, etc.

3. See the STCPOST OS/VS JCL Procedure Parameters section for a description of the TEST parameter.

STARTING THE STCPOSTD PROCEDURE AT THE OPERATOR'S CONSOLE The following START command is used to start the STCPOSTD

Procedure at an OS/VS system console.

S STCPOSTD,U=disk,V=volser[,DS='dsname' [,TEST=x]]

6-12 FE-001-4

OS/VS del

NOTE

1. This OS/VS operator START command requires that the STCPOSTD OS/VS JCL procedure be installed in SYS1.PROCLIB or a similar procedures library.

2. OS/VS1 operating systems require that the parti-tion number be specified after STCPOSTD, i.e. 'S STCPOSTO. Pn, ... ' , where n is the par t ; t i on number.

3. If the OS parameter is specified, the data set name must be entered in upper case.

4. See the Basic OS/VS JCL section for the descrip-tions of disk, tape, etc.

5. See the STCPOSTO OS/VS JCL Procedure Parameters section for the description of the TEST parameter.

THE STCPOSTO OS/VS JCL PROCEDURE

The STCPOSTO OS/VS JCL procedure is used when testing offline devices. No test devices are defined by this procedure. All test devices must be defined via the DEFINE function.

The STCPOSTO procedure can be executed by either a batch job, or by using the OS/VS START command. When this procedure is used, the Control Card Editor is always invoked and the control cards must be defined at the operator's console.

STCPOSTO OS/VS JCL PROCEDURE PARAMETERS

The STCPOSTO OS/VS JCL procedure has a single parameter which is used to specify the control card set to be used. This parameter

is described below.

TEST PARAMETER

The TEST parameter specifies the control card set name or number that the Control Card Editor will supply. If this parameter is not specified, the Control Card- Editor will allow the control cards to be defined at the operator's console. Refer to Chapter 9, The Control Card Editor.

OS/VS JCL

USING THE STCPOSTO PROCEDURE IN A BATCH JOB

The following JCL is used to execute the STCPOSTO Procedure in a batch job.

1 Iljobname JOB acct-info,name, ...

II

EXEC PROC=STCPOSTO [,TEST=x 3

II

Following is a description of each card in the example job.

1. The JOB card is installation dependent.

2. The EXEC card requests that the STCPOSTO OS/VS JCL procedure be executed.

3. This card indicates the end of the job JCL deck.

NOTE

1. This job requires that the STCPOSTO OS/VS JCL pro-cedure be installed in SYS1.PROCLIB or a similar procedures library.

2. See the STCPOST OS/VS JCL Procedure Parameters section for a description of the TEST parameter.

STARTING THE STCPOSTO PROCEDURE AT THE OPERATOR'S CONSOLE

Im Dokument For Program (Seite 37-51)