AFT.NAME - return aftname/filecode.

Alternate Entry Name: AFT_NA

Usage:

B:
   ret = aft.name( unit [, vector] );
C:
   int *aft_name(FILE *unit, int *vector);

Where:

ret
is zero if "unit" refers to a terminal or closed unit. Otherwise, "ret" has one of the non-zero values described below.
unit
is the unit whose aftname is desired.
vector
is a two-word result vector. In TSS, this will contain the aftname of the file. In batch, "vector[0]" will contain the filecode and "vector[1]" will contain the tape serial number if applicable.

Description:

In TSS, AFT.NAME is used to get the aftname associated with an open unit. In batch, AFT.NAME gets the filecode (and tape label). If the given unit is not currently open or if it is associated with a terminal, "ret" will be zero and the contents of "vector" will be undefined. If the unit is open and is not a terminal, "ret" will point to the aftname/filecode. If "vector" is omitted, "ret" will point into the IOV; otherwise, "ret" is set as a pointer to "vector[0]".

Even though "vector" points to two words containing the aftname in ASCII characters (in TSS), "vector" is not a B string since it has no trailing '*e'. This is because "vector" is principally used for system calls (DRL's and MME's).

Copyright © 1996, Thinkage Ltd.