Using KSAM/XL and KSAM 64 (32650-90886)

Chapter 9 87
KSAM Intrinsics
FFILEINFO
61 CA NS 3000/XL remote environment ID name
Note: If using NS 3000/XL RFA (remote file access), specify DSDEVICE
ldev#
when
using a DS (point-to-point or X.25) link. A buffer must be provided for the node
name (or
envid
) with the required space of 52 bytes; otherwise, data corruption
may occur on variables following
itemnum
=61 or an FSERR 73, BOUNDS
VIOLATION may be returned.
62 CA File lockword (8 bytes):
63 CA Unique file identifier (UFID) (20 bytes):
64 @64 Virtual address of the file: Applicable for standard disk files only. (Requesting
itemnum
s 64, 74, or 75 for any other file type, RIO, MSG, CIR, causes an error
and returns CCL (1).)
65 Reserved for the operating system.
66 @32 Virtual address of global unique file descriptor (GUFD):
67 U32 (NM) Record size (indicates bytes)
68 U32 Block size (indicates bytes)
69 U32 Extent size (indicates bytes)
74 @64 Virtual address of file label: Applicable for standard disk files only. (Requesting
itemnum
s 64, 74, or 75 for any other file type (RIO, MSG, CIR) causes an error
and returns CCL (1).)
75 CA Hardware path: Applicable for standard disk files only. (Requesting
itemnum
s 64,
74, or 75 for any other file type (RIO, MSG, CIR) causes an error and returns CCL
(1).)
76 CA Volume restriction (34 bytes): The last two characters indicate the type:
0 File placed on the specified volume at creation
1 File can be placed on any volume containing the specified class
at creation
2 File can beplaced on any volume within the specifiedvolume set
at creation (Default)
77 U32 Transaction management log set ID If
itemnum
77 = 0 (zero), the file is not
attached to the XM (Transaction Management) log.
78 U32 Spoolfile device file number:
Bits (1:31) = Device file number
Bit (0:1) = 1 Output spoolfile
Bit (0:1) = 0 Input spoolfile
Table 9-2. FFILEINFO Itemnum/Item Values
Item
num
Item
Type
Item Description