- 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:
- BLKSIZE can not exceed 400.
- 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:
- A base only system or
- 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.