If the simple source does not reference a valid station title, as specified for the current network in the Network Definition Language II (NDLII) description, then the REPLACE FAMILY-CHANGE statement has the following effects:
-
<file designator>.FAMILY is unchanged.
-
<file designator>.ATTERR is given the value TRUE, and <file designator>.ATTYPE is set to the appropriate value.
-
An appropriate error message is displayed on the Operator Display Terminal (ODT).
-
The program continues.
If <up or down> is *–and the simple source specifies a valid station as defined by the current NDLII description, but the specified station is not currently a member of the family, then the REPLACE FAMILY-CHANGE statement makes no change to the specified family. No error condition is indicated (such a situation is not considered to be an error) and control passes to the next statement of the program.
If, after execution of a REPLACE FAMILY-CHANGE statement, the remote file is closed with release and later reopened, the family reverts to its NDLII-specified value. However, if the remote file is closed with retention and later reopened, the family retains its changed value.
When the REPLACE FAMILY-CHANGE statement is executed, a call is made on an operating system procedure to perform the desired function.
