gtps4m2tSystem Generation

GENSIP

The GENSIP macro performs the following functions:

The GENSIP macro is required; it must be the last SIP Stage I input macro.

Format




Notes:

  1. dsname5 must be a list of 1 to 15 data set names

  2. Must be a list of up to 16 valid MVS data set names.

JCL
Specifies that Stage II JCL only be generated. Stage II will be nonexecutable when this parameter is used. Note that JCL is a positional parameter and must be coded as the first operand when used. The default is a complete Stage II.

Caution:
A production SIP Stage I run must not use this parameter.

VOLNLGF=nnnn
Specifies the numeric portion of the loader general file volume serial number. It may be a 1-4-digit decimal number , but any number shorter than four digits will be padded with leading zeros. The value of VOLNLGF is concatenated to the character portion which is passed via the VSNCHAR parameter of the ONLFIL macro. The resulting string is formatted as the LGF VSN in Stage II processing.
Note:
The LGF VSN is always generated in the AANNNN format, regardless of the migration driver status. (See the OLDVSN parameter of ONLFIL for information about activating the migration driver.)

XREF=(NO|rtype,FULL|ctype,SHORT|otype)
This parameter allows the user to specify the type of cross reference listing desired for each of the program types assembled or compiled during execution of SIP Stage II. Each cross reference may be specified as either SHORT, FULL, or NO.

rtype
Specifies the cross reference option desired for real-time (also referred to as E-type) programs. Also included are keypoints as well as real-time special, user real-time, C language real-time, and C language user real-time programs.

For C language programs, there is no differentiation made for FULL vs. SHORT cross references. Either FULL or SHORT will instruct the C compiler to produce a cross reference.

ctype
Specifies the cross reference option desired for the control program CSECTs.
Note:
If the multiple database function (MDBF) is in the system, this parameter is only valid for the basic subsystem (BSS) generation. (BSSGEN=YES in the SSDEF macro.)

otype
Specifies the cross reference option desired for offline program assemblies.

USRCE=dsname1
Specifies an optional user real-time (UR) and/or C language user real-time (CUR) source library to be included in the Stage II assemblies. If this operand is included, dsname1 must be the name of a cataloged data set. The default is no user source library referenced.
Note:
BLKSIZE cannot exceed 400.

USMAC=dsname2
Specifies an optional user macro library to be included in the SYSLIB data definition for the Stage II assemblies. If this operand is included, dsname2 must be the name of a cataloged data set. The default is no user macro library will be referenced.

Notes:

  1. BLKSIZE can not exceed 400.

  2. This parameter is not used for C language compiles.

USOBJ=dsname3
Specifies an optional user object library to be included in the link-edit steps of Stage II. If this operand is included, dsname3 must be a cataloged data set. The default is no user object library will be called.
Note:
BLKSIZE can not exceed 400.

USPROC=SYS1.PROCLIB|dsname
Specifies the data set to contain the procedures generated for RT, UR, CRT, CUR, OL and CP MASM assemblies and compilations. The procedure to compile offline PL/I segments also resides here. Any valid qualified MVS data set name can be used. This data set must be allocated and cataloged by the user before running SIP.

RELNN=nn
Indicates release level if different than release level of GENSIP macro being used. The default is the two-digit release number. For example, nn is 24 for TPF 2.4.

BRELN=nn
The release level used for the basic subsystem generation. This parameter is to be provided only for the generation of a nonbasic subsystem generation in a MDBF environment and will be ignored if coded for the generation of a basic subsystem. The default is the same as RELNN.

LGFDV=(3380,885)|(dvtype,[cyl])
Specifies the device type of the loader general file volume. For more information about valid device types, see TPF Migration Guide: Program Update Tapes. If the device type is coded but the number of cylinders is not then the number of cylinders defaults to the total number of cylinders on the device.

LISTAPE=SYSOUT|(olvsn,cpvsn,rtvsn,utvsn)
Specifies the volume serial number of the magnetic tape to be used to contain the listings produced by the Stage II assemblies using the multiple assembler program (MASM). If any of the following variables are not coded, a scratch tape will be used. The default is the SYSOUT printer if no LISTAPE operands are coded.

olvsn
This volume serial number will be used for the offline program listings.

cpvsn
This volume serial number will be used for the control program listings.

rtvsn
This volume serial number will be used for the assembler and C language real-time program listings.

utvsn
This volume serial number will be used for the assembler and C language user real-time program listings.

The volume serial numbers are all positional and may be coded as a specific value (i.e 123456 or ABCDEF), as SCRATCH or left uncoded. A combination of the three may also be coded. However, SYSOUT may not be coded together with a serial number.

Examples:

LISTAPE=(,,,)              4 scratch tapes will be used
LISTAPE=(,ABCDEF,SCRATCH)  3 scratch tapes for OF (olvsn),
                           RLT & CRT (rtvsn) and
                           UR & CUR (utvsn) and
                           volume ABCDEF used for CP (cpvsn)
Note:
A tape will always be assigned for each program type. The actual request for the tape will be made only if the procedure is invoked in Stage II.

REGN=8192|size
Specifies the region size (in 1KB units) to be used by the assembler and PL/1 compiler for object code generation. The default is 8192, which will be the minimum region size for Stage II assemblies. If the user specifies REGN as less than 8192, the input will be ignored.

Example:

GENSIP LISTAPE=LIST01,REGN=8192

ASMSPACE=(6800,(800,200))|(xxx,(nnnnn,mmmmm))
Specifies the size of the MVS SYSUT1 dataset for TPF system and object code assemblies. ASMSPACE corresponds to the SPACE parameter on the DD card for the SYSUT1 dataset, but it supports only the TRK, CYL, blocklength, primary quantity, and secondary quantity parameters. For additional information, please consult MVS/ESA JCL Reference.

Whenever a coding error is encountered with ASMSPACE, the default is taken.

xxx
This parameter refers unit of space reserved for the SYSUT1 dataset. It may be coded as TRK, for tracks, or CYL, for cylinders, or as a decimal number, for a block size. If block size is chosen, then the number must fall in the range 1-65535 inclusive. If ASMSPACE is coded, then this subparameter must be coded.

nnnnn
This is a nonzero decimal number representing the primary quantity of the units described by the first subparameter. If ASMSPACE is coded, then this subparameter must be coded.

mmmmm
This is a decimal number representing the secondary quantity of the units described by the first subparameter.

ASMTYPE=(I)|H
Specifies which assembler to use: the H assembler or the high-level assembler (HLASM). The default is I, which is the HLASM.

OUTCL=(K|class1,D|class2,A|class3)
Indicates the print output classes for the MVS SYSOUT parameters to be used when assembling CP, RT, UR and OL programs, or when compiling CRT or CUR programs. A class is an alphameric character (A-Z, 0-9) that corresponds to a type of unit record device, specified by an installation.

class1
Indicates the print output class for control program (CP) CSECTs. If the MDBF feature is present in the system then this parameter is only valid for the basic subsystem generation (BSSGEN=YES in SSDEF macro.)

class2
Indicates the print output class for all types of real-time programs. Generated keypoints also use this class.

class3
Indicates the print output class for offline (OL) programs.

Note:
Any class may be omitted provided positional integrity is kept. Following are some examples showing valid forms:
OUTCL=(B,,C)      CP=B,RT=D,OL=C
OUTCL=(B,A)       CP=B,RT=A,OL=A
OUTCL=(,,K)       CP=K,RT=D,OL=K
OUTCL=B           CP=B,RT=D,OL=A

PL1LK=LINKLIB|dsname4
Specifies the PL/I compiler library. If this operand is included, dsname4 is automatically prefixed with 'SYS1.'. The resulting data set name must be a cataloged data set.
Note:
BLKSIZE cannot exceed 400. Do not code SYS1. It will be generated by the system.

PL1SR=PLIBASE|dsname51|(dsname51[,dsname52,...,dsname515])

Specifies the PL/I subroutine library or libraries. When dsname5 is coded, it must be a list of 1 to 15 data set names separated by commas. Each name is prefixed automatically with 'SYS1.'. The resulting data set name must be a cataloged data set.

The data sets will be concatenated in the same order as they appear in dsname5.

Note:
BLKSIZE cannot exceed 400. Do not code SYS1. It will be generated by the system.

ANTPDS=OSTG.PDS.G01|dsname6
Specifies the data set to be used to contain the offline SNA table generation program application name table definitions. See TPF ACF/SNA Network Generation. Any valid qualified MVS data set name can be used. This data set must be cataloged. The string .BSS will be automatically appended to the end of the data set name coded in the basic subsystem of a multiple database function (MDBF) environment.
Note:
This parameter is only to be coded when generating either:
  1. A base only system or
  2. The basic subsystem in a multiple database function (MDBF) environment.

LINKALL=NO|YES
Specifies whether SIP will send link-edited jobs to a stage II deck for a C load module.

NO
Specifies that SIP will send link-edited jobs to a stage II deck for all programs where NO is specified for the LINK parameter on the SPPBLD macro. This is the default.

YES
Specifies that SIP will send link-edited jobs to a stage II deck for all programs where ICL is specified for the TYPE parameter on the SPPBLD macro, regardless of how the LINK parameter on the SPPBLD macro is coded.

See Modifying the Program Tables for more information about the SPPBLD macro.

ASMALL
This parameter allows the user to override the OBJ parameter of the SPPGML (program list) macro. (See Modifying the Program Tables).

NO
Specifies that the assembly process is to be controlled by the OBJ parameter of the SPPGML macro.
Note:
ASMALL=YES is coded only when generating a base only system or when generating the basic subsystem in a multiple database function (MDBF) environment.

YES
Specifies that all programs defined in the SPPGML macro are to be assembled or compiled and that the OBJ parameter is to be ignored.
Note:
There is an exception. Programs with the TYPE=OCO designation are not affected by ASMALL=YES.

EXPRS=jobname
This parameter allows users to define the job in Stage II that will be generated by Stage I. By specifying this parameter, only the jobs named will be generated. The valid job names are F2, G1, G2, G4-G6, H, I1-I3,S, JA, JB, JC, JD, JE, JF, J1-J10, K, L1-L6, M, and S. Specifying job name M will cause the SIP report to be generated. All other job names are defined in Appendix C, SIP Stage II Job Summary. The default is all jobs.

Example:

If a user only wanted to generate the first three jobs in the SIP, (SIPF1A, SIPF1B, and SIPF2A), the EXPRS parameter would be coded as follows:

EXPRS=F
  or
EXPRS = (F2,G1)

Multiple job steps can be defined by separating each step name with a comma and enclosing the parameters in parentheses.

Note:
Extreme care must be taken when using this parameter because of the dependencies of each of the Stage II jobs.

EXCJOB=1|n
This parameter specifies the number of MASM execute statements per job in the real-time section J4 and the user real-time section J7. This parameter is only useful when listings are printed to tape. It reduces the number of jobs produced thereby decreasing the number of tape mounts.
Note:
When printing a large number of programs, use a tape with the largest format possible for your tape device to insure that the programs will fit on one tape. Also, it is recommended that you mount each tape as private to minimize the number of tape mounts.

Example:

mount device,vol=(SL,label),use=private

CFLAG
This parameter specifies the C language compile-time FLAG option, which determines the minimum severity of error that requires a message to be generated.

I
List all messages

W
List all except information messages

E
List all except warning and information messages

S
List only severe error and unrecoverable error messages

If the parameter is omitted, then the NOFLAG default is set.

CLSRCH=dsname71[,dsname72,...,dsname716]
This parameter specifies the C language compile-time LSEARCH option. The LSEARCH option directs the preprocessor to look for the user #include files in the libraries. The arguments to CLSRCH must be a list of up to 16 valid MVS data set names. These data sets will be added the USERLIB DD card of the C compilation procedure created by Stage I. They will be concatenated in the order specified on the CLSRCH parameter (the first subparameter will be the first data set in the USERLIB concatenation list). These data sets must be cataloged.

CSRCH=dsname81[,dsname82,...,dsname816]
This parameter specifies the C language compile-time SEARCH option. The SEARCH option directs the preprocessor to look for the system #include files in the libraries. The argument to CSRCH must be a list of up to 16 valid MVS data set names. These data sets will be added to the SYSLIB DD card of the C compilation procedure created by Stage I. They will be concatenated in the order specified on the CSRCH parameter (the first subparameter will be the first data set in the SYSLIB concatenation list). This data set must be cataloged. See the TPF Application Programming for more information.

Attention: Do not add either the VM or MVS C language header data set to SYSLIB. These data sets have been deliberately omitted from the SIP generated C compilation procedures. The VM and MVS headers provide some functions which are incompatible with a TPF environment. If these headers were added, then a C program segment might compile without errors or warnings, but it would be unusable in a TPF environment.

CCOMPTP
This parameter specifies the compiler that will be called to compile the TPF C language programs.

G
Causes an IBM OS/390 C/C++ compiler to be called from the partitioned data set (PDS) specified with the CLNGPFX parameter.
Note:
The SIP Stage II deck will not include JCL to compile TARGET(TPF) code (whether it exists or not) because OS/390 compilers do not support TARGET(TPF) code. If you have TARGET(TPF) code, you are responsible for compiling it using an MVS compiler outside the SIP process.

CLIBPFX=SYS1.CEE|dsname9
This parameter specifies the prefix name of each PDS that contains the run-time library that is used by the C compiler. The default is SYS1.CEE, which is the LE runtime library.

CLNGPFX=SYS1.CBC|dsname10
This parameter specifies the prefix name of each PDS that contains the C compiler. The default is SYS1.CBC.

Examples

None.

References

None.