Assembler macros

This section describes Assembler macro interfaces which are affected by large objects.

The macros mentioned are described in the following manuals: “Executive Macros” [11] (STAMCE macro) or “DMS Macros” [3] (all other macros)

Summary of Assembler macros

Macro/operand or RC	Explanation
Executive macros
STAMCE SELECT=LARGE_OBJECTS/ LARGE_FILES_ALLOWED	Select and display the LARGE_OBJECTS and LARGE_FILES_ALLOWED attributes
DMS macros
FSTAT VERSION=0/1	If FSTAT is called with these versions, you must check whether it is necessary to convert to VERSION=2/3. X'0576': Extended return code for large files
OPEN	Be aware of problems regarding semantics X'0D9D': Additional return code X'0D00': Additional return code
FCB LARGE_FILE=*FORBIDDEN/ *ALLOWED	Only for disk files: LARGE_FILE specifies whether the file may become a “large” file (i.e. whether its size may increase beyond 32 GB during processing).
FILE EXC32GB=*FORBIDDEN/ *ALLOWED	Only for disk files; determines whether or not the file size may exceed 32 GB during processing
RDTFT	Information about the file property EXC32GB in the output area

 

Macro/operand or RC	Explanation
DMS macros for special access methods
DIV LARGE_FILE=*FORBIDDEN/ *ALLOWED OFFSET=number SPAN=number	Operand LARGE_FILE for FCT=*OPEN: specifies whether the file to be opened may become a “large” file that can exceed 32 GB in size. Operand OFFSET for FCT=*MAP/*SAVE/*RESET: Specifies the first block of the file region to be mapped in virtual address space. The value for OFFSET is limited by the maximum size of a file, thus; 8388606 when LARGE_FILE= *FORBIDDEN or. 1073741823 when LARGE_FILE=*ALLOWED. Operand SPAN for FCT=*SAVE/*RESET: Specifies the length of the file region in 4-KB blocks. The value for SPAN is limited by the maximum size of a file, thus; 8388607 when LARGE_FILE=*FORBIDDEN or 1073741824 when LARGE_FILE=*ALLOWED. X'000C': Return code INVALID_LARGE_FILE X'0030': Return code LARGE_FILE_NOT_SPECIFIED
FPAMSRV LARGE_FILE=*FORBIDDEN/ *ALLOWED	Address problems of semantics Operand for FCT=*OPEN:LARGE_FILE specifies whether the file to be opened may become a “large” file that can exceed 32 GB in size. X'0015': Return code INVALID_LARGE_FILE
FPAMACC BLOCK=number	Specifies the direct decimal numeric value for the number of the first logical block to be transferred. The value for BLOCK is limited by the maximum size of a file, thus; 8388606 when LARGE_FILE=*FORBIDDEN or 1073741823 when LARGE_FILE=*ALLOWED. (specified in the FPAMSRV macro) X'0145': Return code LARGE_FILE_NOT_SPECIFIED