RENAME: Rename symbolic references

z/OS MVS Program Management: Advanced Facilities

RENAME: Rename symbolic references

z/OS MVS Program Management: Advanced Facilities
SA23-1392-00

This function renames a symbolic reference if a reference to the old name remains unresolved at the end of the first pass of autocall. For a complete explanation of the autocall process, see the information on resolving external references in z/OS MVS Program Management: User's Guide and Reference.

The syntax of the RENAME call is:

[symbol]

IEWBIND

FUNC=RENAME

[,VERSION=version]
[,RETCODE=retcode]
[,RSNCODE=rsncode]
,WORKMOD=workmod
,OLDNAME=oldname
,NEWNAME=newname

FUNC=RENAME: Requests the RENAME function.
VERSION=1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: Specifies the version of the parameter list to be used. The default value is VERSION=1.
RETCODE=retcode — RX-type address or register (2-12): Specifies the location of a fullword integer that is to receive the return code returned by the binder.
RSNCODE=rsncode — RX-type address or register (2-12): Specifies the location of a 4-byte hexadecimal string that is to receive the reason code returned by the binder.
WORKMOD=workmod — RX-type address or register (2-12): Specifies the location of an 8-byte area that contains the workmod token returned on the CREATEW request. You must not modify this token.
OLDNAME=oldname — RX-type address or register (2-12): Specifies the location of a 32K–1 byte varying character string that contains the symbol to be renamed. The format consists of a 2-byte length field followed by the actual name. The length does not include the first two bytes.
NEWNAME=newname — RX-type address or register (2-12): Specifies the location of a 32K–1 byte varying character string that contains the symbol to which the old name should be changed. The format consists of a 2-byte length field followed by the actual name. The length does not include the first two bytes.

Processing notes

The only immediate result of the RENAME API call is that the new rename request will be added to the list of such requests. Nothing else will be done until final autocall processing. At the end of the first pass of autocall (that is, when all possible references have been resolved with the names as they were on input), rename processing will be performed.

Return and reason codes

The common binder API reason codes are shown in Table 1.

Return Code	Reason Code	Explanation
00	00000000	Normal completion. The binder added the rename request to the rename list successfully.
04	83000501	Either the OLDNAME or the NEWNAME already existed in the binder rename list. The rename request was not successful (i.e., the request was not added to the binder rename list).

Parameter list

If your program does not use the IEWBIND macro, place the address of the RENAME parameter list in general purpose register 1.

Table 1. RENAME parameter list

`PARMLIST`	`DS`	`0F`
	`DC`	`A(RENAME)`	Function code
	`DC`	`A(RETCODE)`	Return code
	`DC`	`A(RSNCODE)`	Reason code
	`DC`	`A(WORKMOD)`	Workmod token
	`DC`	`A(OLDNAME)`	Reason code
	`DC`	`A(NEWNAME+X'80000000')`	RENAME list & end-of-list indicator
`RENAME`	`DC`	`H'22'`	RENAME function code value
	`DC`	`H'version'`	Interface version number
`OLDNAME`	`DC`	`H'nnn',CLnnn`	Old name
`NEWNAME`	`DC`	`H'nnn',CLnnn`	New name