gtpi1m6lSystem Installation Support Reference

Printing Multiple Assembly and Compilation Listings

The Multiple Assembly/Compilation Print (ASMP) program causes multiple assembly and compilation listings to be printed. Each listing will be preceded by a header page identifying the program name. You control what gets printed by changing the JCL control cards.

To print multiple assembly and compilation listings, make a JCL control deck and run the deck as a batch job under OS.

JCL Control Cards

The JCL control cards are an EXEC card for the program, a STEPLIB or JOBLIB card for the PDS in which the program is stored, and the following cards:

MSGFILE
This DD card specifies a SYSOUT DD statement for messages from the program.

LISTAPE
This DD card specifies the input tape or disk created during a MASM run.

PRINTOUT
This DD statement specifies a SYSOUT DD statement for the listings that are being retrieved from tape.

ASMPCTL
This card controls whether all listings or specific listings are printed. //ASMPCTL DD DUMMY prints all of the listings on the input tape. //ASMPCTL DD *, with the LIST parameter, prints the specific listings included in the LIST statement.

LIST
This card controls which program listings are printed. One or more program listings can be requested. If there is only one request in the list, parentheses are not required. The program name is the member name in the source PDS from which it was generated. The names are not required to be in any order.
Note:
If a suffix was attached to the program name during the assembly or compilation, make sure it is included in your LIST statement

A list can appear on several cards. The following example shows a list continued on more than one card:

LIST=(PPCP40,,BMP040,BMP140,BMP240,BMP340,BMP440, BMP540,BMP640,BMP740,BMGL40,LTPP40,LTPQ40,ACPL40, ICDF40)

Note:
If continued on the next card, the last name on the previous card must be followed by a comma. Only columns 1-71 of any card can be used.

The sample JCL that follows is designed to print 2 programs from tape.

//LISTJOB  EXEC PGM=ASMPvv
//STEPLIB  DD DSN=ACP.LINK,RELvv,DISP=SHR
//LISTAPE  DD DSN=PRINT,UNIT=TAPE,VOL=SER=LISTAP,DISP=OLD,
//  DCB=(BLKSIZE=23940,RECFM=FBA)
//PRINTOUT DD SYSOUT=A,DCB=(BLKSIZE=133,RECFM=FBA)
//MSGFILE  DD SYSOUT=A,DCB=(RECFM=FBM,LRECL=80,BLKSIZE=80)
//ASMPCTL  DD *
       LIST=(CZXPA0,CZXDA0)
/*

Notes:

  1. vv refers to the actual TPF release number being executed against.

  2. The LISTAPE data definition must define as input the same device (for example, tape or disk) as the LISTAPE data definition that was used to execute MASM. Also, if you have more than 1 input tape, specify all of the tape IDs (for example, VOL=SER=(123456,789012)).

Return Codes

0
Successful execution.

4
One or more programs specified in LIST option not found (see error messages).

8
Error in ASMPCTL data definition (see error messages).

Error Messages

Message:
KEYWORD ON CONTROL CARD IS NOT -LIST-

Explanation:
A control card has been read on which the keyword is not LIST.

 
 

Message:
INSUFFICIENT CORE - INCREASE REGION SIZE

Explanation:
The program issued a GETMAIN request for core to build a list from the control cards. The GETMAIN was unsuccessful. The program should be executed with a larger region or partition size.

 
 

Message:
MAX (n) NO OF ENTRIES ALLOWED IN CONTROL CARD LIST EXCEEDED-INCREASE VARIABLE &LISTMEM AND REASSEMBLE

Explanation:
The program can print a list containing as many as n programs. The list that is input to the program exceeds this number of entries. This can be resolved by changing the value of local variable &LISTMEM in the program and reassembling the program. An easier way to resolve this problem might be to run the program more than once with a smaller control card list.

 
 

Message:
INVALID SYNTAX IN CONTROL CARD

Explanation:
Self-explanatory.

 
 

Message:
ENTRY IN CONTROL CARD LIST EXCEEDS 8 CHARACTERS

Explanation:
Self-explanatory.

 
 

Message:

***** ASMP ERROR REPORT *****
--------NOT FOUND ON LISTAPE

Explanation:
Program identified was requested via LIST option but not found during search of LISTAPE input. Verify program name from output of MASM.