TYPE=SET parameter of IEFSSVTI

The IEFSSVTI macro with the SET parameter modifies a function routine entry in an existing input table.

Syntax

The syntax of the IEFSSVTI macro with TYPE=SET is written as follows:

Syntax	Description

`name`	`name`: symbol. Begin `name` in column 1.

␢	One or more blanks must precede IEFSSVTI.

IEFSSVTI

␢	One or more blanks must follow IEFSSVTI.

TYPE=SET

,SSVTDATA=`ssvtdata`	`ssvtdata`: RS-type address

,SOURCE=`source`	`source`: RS-type address or address in register (2) - (12).

,ENTRYDATA=`entrydata`	`entrydata:` RS-type address or address in register (2) - (12).

,FUNCNAME=`funcname`	`funcname`: RS-type address or address in register (2) - (12).
,FUNCADDR=`funcaddr`	`funcaddr`: RS-type address or address in register (2) - (12). Default: none

,FUNCAMODE=`HOB`	Default: FUNCAMODE=HOB Note: FUNCAMODE is valid with FUNCADDR.
,FUNCAMODE=`31`
,FUNCAMODE=`24`

,FCODES=`fcodes(,fcodes...)`	`fcodes`: RS-type address or address in register (2) - (12).
,FCODES=`0`	Default: FCODES=0

Parameters

The parameters are explained as follows:

TYPE=SET

A parameter that modifies a function routine entry in an existing input table. You can use TYPE=SET to modify either a table in dynamic storage, or a static table in non-reentrant programs.

,SSVTDATA=ssvtdata

A required parameter that specifies the name of the function routine input table to be modified. The name must match the name of a table specified on the SSVTDATA parameter of the TYPE=INITIAL or TYPE=RESERVE IEFSSVTI macro invocation.

,SOURCE=source

A required parameter that specifies the name of the original function routine input table from which the table to be modified was copied.

The name must match the name of a function routine input table that you specified in the SSVTDATA parameter on a TYPE=INITIAL invocation or a TYPE=RESERVE invocation. This information is used with the ENTRYDATA parameter to calculate the offset of the function routine input table you want to modify.

The SOURCE parameter and SSVTDATA parameter can refer to the same function routine input table. For example, you may want to modify a static function routine input table that was created by a set of TYPE=INITIAL and TYPE=FINAL invocations, which can be done only in non-reentrant modules.

,ENTRYDATA=entrydata

A required 4-byte parameter that specifies the name (or address) of the index of the function routine input table entry that you want to modify. This input field may be either a constant, an assembler equate, or decimal value.

If the value of the ENTRYDATA parameter is greater than the number of function routines in the source table, the target function routine input table does not change. If this is the case, you will not receive a compile-time warning message, because this situation is determined at run time.

,FUNCNAME=funcname

,FUNCADDR=funcaddr

An optional set of parameters. You can specify only one of the following:

FUNCNAME=funcname

The function routine name. This name can be no more than 8 characters long, beginning with an alphabetic character or national (#, @, or, $) character. The remaining characters can be alphabetic, national, or numeric.

This field must be left-justified and padded to the right with blanks.

For a TYPE=ENTRY request, if you omit FUNCNAME, you must provide the function routine information about this request.

FUNCADDR=funcaddr

The pointer input that contains the address of the function routine. Specifying FUNCADDR on a TYPE=ENTRY invocation, reserves storage in the function routine input table for the function routine address.

If you specify FUNCADDR on this invocation, you can use the high-order bit to specify the function routine AMODE. Setting this bit indicates that the routine receives control in AMODE 31. Clearing this bit indicates that the routine receives control in AMODE 24. You can also use the FUNCAMODE key to indicate the AMODE of a function routine.

,FUNCAMODE=HOB

,FUNCAMODE=31

,FUNCAMODE=24

An optional input parameter that specifies the AMODE of a function routine identified by the address. The SSI uses this information to determine the AMODE in which the function routine receives control.

If you do not specify the FUNCAMODE parameter, the high-order bit of the address specified with the FUNCADDR parameter indicates the AMODE of the function routine. If the high-order bit is on, the function routine is treated as AMODE 31.

FUNCAMODE=HOB specifies that the high-order bit of a function routine address indicates the AMODE in which the function routine receives control. HOB is the default.

FUNCAMODE=31 specifies that the function routine receives control in AMODE 31.

FUNCAMODE=24 specifies that the function routine receives control in AMODE 24.

,FCODES=fcodes(,fcodes...)

,FCODES=0

An optional byte parameter that specifies the function codes supported by the associated function routine. This input field contains a decimal value that must be in the range of 1 to 255.

The same function code value cannot appear more than once within a set of IEFSSVTI invocations representing a function routine input table.

You must specify the FCODES parameter if the function code information was not provided on the TYPE=ENTRY invocation that corresponds to the entry being modified.

Function codes that you specify with the TYPE=SET invocation replace any function codes specified on the original TYPE=ENTRY invocation. If you do not specify the FCODES parameter the function code information in the entry being modified is unchanged.

If you specify more function codes with the FCODES parameter than the maximum number of function codes for which room was reserved in the table entry being modified, the function code information in the target entry is unchanged. The IEFSSVTI macro does not provide a warning.

The default is 0.