Setting options with the binder API

Many options can be set by using STARTD and SETO to specify options and values. You can set most of the options that can be set in the PARM field of the EXEC statement and there are a few options for use only through the API functions.

Any option can be set using STARTD call. All options except the CALLERID, COMPAT, EXITS, LINECT, MSGLEVEL, OPTIONS, PRINT, TERM, TRAP, and WKSPACE options can also be set using the SETO call (or the SETOPT control statement). Negative keywords (for example, NOLIST or NOMAP) cannot be used with the OPTION operand of SETO or the options list of the STARTD. These options are set by assigning the value NO to the primary option. Refer to the descriptions of the STARTD and SETO operands for further information.

Table 1 lists options with allowable and default values. Numeric values are coded as numeric character strings unless otherwise specified. The table also references any corresponding batch options.

Table 1. Setting options with the binder API
Option	Description	Allowable Values	Default Value	Environmental	Valid for INTENT=ACCESS
AC	Sets the APF authorization code in the saved module. Also see AC option in z/OS MVS Program Management: User's Guide and Reference.	0 - 255	0		YES
ALIASES	Allows you to mark external symbols as aliases for symbol-resolution purposes.	ALL/NO	NO		YES
ALIGN2	Requests 2KB page alignment. Also see ALIGN2 option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		NO (see note 2)
AMODE	Sets the addressing mode. For a detailed description, see AMODE option in z/OS MVS Program Management: User's Guide and Reference.	24, 31, 64, ANY, MIN	Derived in ESD		YES
CALL/NCAL	Allows or disallows automatic library call. Also see CALL option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	Y		NO (see note 2)
CALLIB	Specifies the library for automatic call.	ddname of 1 to 8 characters	None		NO (see note 2)
CALLERID	Specifies string to be printed at the top of each page of the binder output listings.	Character string of up to 80 bytes	None	YES	YES (see note 1)
CASE	Specifies case sensitivity for symbols. Also see CASE option in z/OS MVS Program Management: User's Guide and Reference.	UPPER, MIXED	UPPER		YES
COMPAT	Specifies binder compatibility level.	LKED, PM1, PM2, PM3, PM4, CURRENT, MIN, Release identifier (for example: ZOSV1R7)	MIN	YES	YES (see note 1)
COMPRESS	Controls whether the binder should attempt to compress non-program data to reduce DASD space.	NO, AUTO, YES	AUTO		NO (see note 2)
DC	Allows compatibility with down-level software. Also see DC option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		YES
DCBS	Allows the block size of the SYSLMOD data set to be reset for PDS only. Also see DCBS option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		YES
DYNAM	Determines whether a module being bound is enabled for dynamic linking.	DLL, NO	NO		NO (see note 2)
EDIT	Requests external symbol data to be retained, allowing later reprocessing. Also see EDIT option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	Y		NO (see note 2)
EP	Specifies the program entry point (name,[offset]). Also see EP option in z/OS MVS Program Management: User's Guide and Reference.	(symbol of up to 32767characters [,integer value])	None		YES
EXITS	Specifies user exits.	INTFVAL	None	YES	YES (see note 1)
EXTATTR	Specifies extended attributes for SYSLMOD when saved in a z/OS UNIX file.	See EXTATTR option in z/OS MVS Program Management: User's Guide and Reference.	system setting for SYSLMOD file		YES
FETCHOPT	Sets loading options for program objects. Also see FETCHOPT option in z/OS MVS Program Management: User's Guide and Reference. PACK and PRIME are ignored	PACK or NOPACK, PRIME or NOPRIME	NOPACK, NOPRIME		YES
FILL	Specifies that uninitialized areas of module are to be filled with the byte provided.	Any byte value	None		NO (see note 2)
GID	Specifies the Group ID attribute to be set for the SYSLMOD file.	A string of up to 8 alphanumeric characters which represents a RACF® group name or a numeric z/OS UNIX group ID	system setting for SYSLMOD file		YES
HOBSET	Instructs the binder to set the high-order bit in V-type adcons according to the AMODE of the target.	YES \| NO	NO		NO (see note 2)
INFO	See z/OS MVS Program Management: User's Guide and Reference for more information.	INFO \| INFO=NO \| NOINFO	INFO=NO		YES
LET	Allows errors of a specified severity to be accepted. Also see LET option in z/OS MVS Program Management: User's Guide and Reference.	0, 4, 8, 12	4		YES (see note 3)
LINECT	Specifies number of lines per page of the binder output listings. Also see LINECT option in z/OS MVS Program Management: User's Guide and Reference.	Integer value	60	YES	YES (see note 1)
LIST	Controls contents of the output listings. Also see LIST option in z/OS MVS Program Management: User's Guide and Reference.	OFF, SUMMARY, STMT, ALL NOIMPORT, NOIMP	SUMMARY		YES
LISTPRIV	Obtain a list of unnamed ('private code') sections.	NO \| YES \| INFORM	NO		YES (see note 3)
LNAME	Specifies the program name to be identified to the system. Also see LNAME parameter description in LOADW: Load workmod.	Symbol of up to 8 characters			YES
LONGPARM	This option indicates whether the program supports its parameter being longer than 100 bytes. Also see LONGPARM option in z/OS MVS Program Management: User's Guide and Reference.	Y,N	N		YES
MAP	Requests a module map. Also see MAP option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		YES (see note 3)
MAXBLK	Specifies the maximum record length for the text of a program module. Also see MAXBLK option in z/OS MVS Program Management: User's Guide and Reference.	256 - 32760	32760		YES
MODLIB	Specifies a ddname for the output program library. Also see MODLIB parameter description in SAVEW: Save workmod.	ddname of up to 8 characters	None		YES
MODMAP	See z/OS MVS Program Management: User's Guide and Reference for more information.	NO \| LOAD \| NOLOAD	NO		NO (see note 2)
MSGLEVEL	Specifies the minimum severity level of messages to be issued. Also see MSGLEVEL option in z/OS MVS Program Management: User's Guide and Reference.	0, 4, 8, 12, 16	0	YES	YES (see note 1)
OL	Limits how the program can be brought into virtual storage. Also see OL option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		YES
OVLY	Requests the program be bound in overlay format. Also see OVLY option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		NO (see note 2)
PATHMODE	Specifies pathmode to be used when saving a module to an z/OS UNIX file.	See PATHMODE option in z/OS MVS Program Management: User's Guide and Reference.	Owner permission for read, write, and execute		YES
PRINT	Requests that messages be written to the SYSLOUT or SYSPRINT data set. Also see PRINT option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	Y	YES	YES (see note 1)
RES	Requests that the link pack area queue be searched to resolve references for programs that will not be saved. Also see RES option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		NO (see note 2)
REUS	Specifies the reusability characteristics of the program module. Also see REUS in z/OS MVS Program Management: User's Guide and Reference.	NONE, SERIAL, RENT, REF	NONE		YES
RMODE	Sets the residence mode. Also see RMODE in z/OS MVS Program Management: User's Guide and Reference.	24, ANY, SPLIT	Derived from ESD		YES (see note 4)
SCTR	Requests scatter format. Used only for MVS™ system nucleus load module.	Y, N	N		YES
SIGN	Builds a module signature.	Y, N	N		NO (see note 2)
SNAME	Specifies a member name for a saved program module. Also see SNAME parameter description in SAVEW: Save workmod.	Member name of 1 to 1024 characters	None		YES
SSI	Specifies a system status index. Also see SSI option in z/OS MVS Program Management: User's Guide and Reference.	8 hexadecimal digits	None		YES
STORENX	Prevents an executable module from being replaced by a non-executable module in the target library. Also see STORENX option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		YES
STRIPCL	Removes unneeded classes from a program object or load module. Also see STRIPCL option in z/OS MVS Program Management: User's Guide and Reference.	YES, NO	NO		NO (see note 2)
STRIPSEC	Removes unreferenced unnamed sections from a program object or load module. Also see STRIPSEC option in z/OS MVS Program Management: User's Guide and Reference.	PRIV, YES, NO	NO		NO (see note 2)
SYMTRACE	Specify a symbol name, and requests symbol resolution trace. Also see SYMTRACE option in z/OS MVS Program Management: User's Guide and Reference.	Any valid symbol	None		YES
TERM	Requests that messages be sent to the terminal data set SYSTERM.. Also see TERM option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	Y	YES	YES (see note 1)
TEST	Requests that the program module be prepared for the TSO TEST command. Also see TEST option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		YES (see note 3)
TRAP	Controls error trapping. See z/OS MVS Program Management: User's Guide and Reference for more information.	OFF, ON, ABEND	ON	YES	YES (see note 1)
UID	Specifies the User ID attribute to be set for the SYSLMOD file.	A string of up to 8 alphanumeric characters which represents a user name (such as a TSO logon ID) or a numeric z/OS UNIX user ID	system setting for SYSLMOD file		YES
UPCASE	While processing XOBJs, determines whether symbols should be upper-cased before finalizing symbol resolution during binding.	Y, N	N		NO (see note 2)
WKSPACE	Specifies the amount of space available for binder processing, both below and above the 16 MB line (value1, value2). Also see WKSPACE option in z/OS MVS Program Management: User's Guide and Reference.	Values specified in units 96KB below 16MB and 1024KB above 16MB	All available space	YES	YES (see note 1)
XCAL	Requests that valid exclusive references between program segments of an overlay program module be allowed. Also see WKSPACE option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		NO (see note 2)
XREF	Requests printing of a cross-reference table. Also see XREF option in z/OS MVS Program Management: User's Guide and Reference.	Y, N	N		YES (see note 3)

Notes:

Options identified as Environmental Options have the following rules:
1. They can only be specified at the dialog level by using STARTD, and they will be processed normally with INTENT=ACCESS
2. If they are specified by SETO at either the DIALOG or WORKMOD level (including the SETOPT control statement), the binder will issue error message IEW2274E
3. If they are specified in an options data set, the binder will issue error message IEW2277E.
When a WORKMOD is created with INTENT=ACCESS, options which impact the bind process cannot be used. Such options have the following rules:
1. If they are specified at the DIALOG level (using STARTD or SETO), the binder will validate them syntactically but they will not have any effect
2. If they are specified at the WORKMOD level (using SETO), the binder will issue error message IEW2270E.
When a WORKMOD is created with INTENT=ACCESS, some options which do not impact the bind process can be specified only at the DIALOG level. Such options have the following rules:
1. If they are specified at the DIALOG level (using STARTD or SETO), the binder will process them normally
2. If they are specified at the WORKMOD level (using SETO), the binder will issue error message IEW2270E.
When a WORKMOD is created with INTENT=ACCESS, the RMODE option may be specified and will be processed normally, with the exception of RMODE=SPLIT. This option has the following rules:
1. If RMODE=SPLIT is specified at the DIALOG level (using STARTD or SETO), the binder will validate it syntactically; but it will not have any effect
2. If RMODE=SPLIT is specified at the WORKMOD level (using SETO), the binder will issue error message IEW2270E.