Statements and parameters for IEASVCxx

SVCPARM(svcnum)

Specifies the number of the installation-supplied SVC routine (a decimal number from 200 to 255). When a program issues an SVC instruction that contains this number, the system invokes the corresponding SVC routine.

,REPLACE: Specifies that an SVC table entry is to be updated.

,TYPE(typenum): Specifies the SVC type (1, 2, 3, 4, or 6) being defined.

,EPNAME(epname)

Specifies the entry point name of the SVC routine. The epname value, if specified, must be one of the following:

IGCERROR. Identifies an SVC routine that will result in abend Fxx when SVC xx is issued, where xx matches svcnum
Not IGCERROR.
- For SVC types 3 and 4, epname must be the load module name (or alias) of a load module in the LPA.
- For SVC types 1, 2, and 6, epname must be the entry point name (not the load module name, unless it is the same name) of a module in the nucleus region. The module must have been link-edited directly into the nucleus region, or added to the nucleus region through the NMLDEF macro or NUCLSTx x parmlib member.

For information about the NMLDEF macro, see z/OS MVS Programming: Authorized Assembler Services Guide. For information about the NUCLSTxx parmlib member, see NUCLSTxx (customizing the nucleus region).

The EPNAME parameter is optional, unless you want to specify an EPNAME value other than the IBM® default SVC naming convention.

The default naming convention for routines for SVC types 1, 2, and 6 is IGCnnn, where nnn is the decimal number of the SVC routine.

The default naming convention for SVC routines for SVC types 3 and 4 is IGC00nnn, where nnn is the signed decimal number of the SVC routine. Here, a signed decimal is a number that ends in either of the following ways:

When the last digit of the SVC routine's load module name is a number from 1 - 9, specify an epname that ends with the EBCDIC character (A-I) that corresponds with the last digit. For example, the epname for a type 4 SVC 255 is IGC0025E.
When the last digit of the SVC routine's load module name is zero, specify for the last character of epname, the display representation of hexadecimal C0; in EBCDIC, this is the left brace ({) character. For example, the EPNAME for a type 4 SVC 250 is IGC0025{.

,LOCKS(lockname,lockname,...)

Specifies the name of the system locks this SVC requires. lockname can be either LOCAL or CMS.

Observe the following conventions for the LOCKS parameter:

You do not need to specify the LOCAL lock for SVC type 1; the LOCAL lock is automatically obtained for SVC type 1.
If you specify the CMS lock for SVC types 2, 3, or 4, you must also specify the LOCAL lock.
You cannot specify a global spin lock for SVC types 3 or 4.
You cannot specify locks for SVC type 6.

,APF{YES}|{NO }

Specifies whether the program invoking the SVC must be authorized. A program is considered to be authorized if it meets at least one of the following conditions:

Runs in supervisor state
Holds PSW key 0-7
Is running with APF authorization.

When you specify YES, the program issuing the SVC must be authorized. When you specify NO, the program issuing the SVC can be unauthorized.

Note: NO

NPRMPT{YES} | {NO }: Specifies whether the SVC is non-preemptable (YES) or can be preempted (NO).
Note: NO

,AR{YES} | {NO }: Specifies whether the SVC can be issued in access register ASC mode.
Note: NO