HELP: Write a FLAMFILE record-oriented
TYPE: OBJECT
SYNTAX: FL4(NET.{},NAME/FLAMFILE/FILE='str'/STREAM/DUMMY,MEMBER='str',REMOVE,RENAME='str',REMAIN,NOMKDIR,APPEND,CMPMOD=CX7/CX8/VR8/ADC/NDC,ENCMOD=OFF/AES/FLAMENC,BLKMOD=UNBLOCKED/BLOCKED,MAXBUF=num,MAXREC=num,CLIMIT=num,FLFORG=SEQ/PS/EDS/ESDS/KDS/KSDS/RDS/RRDS/LDS,FLFRCF=VAR/FIX/UND/TXT/DLM/VB/FB/V2B-XBE/V4B-XBE/V4A-ICL/V4E-ICL/V2B-ILE/V2B-IBE/V4B-IBE,FLFRCL=num,FLFRCD=NONE/LF-ASCII/CR-ASCII/NL-ASCII/CRLF-ASCII/LF-EBCDIC/CR-EBCDIC/NL-EBCDIC/CRLF-EBCDIC,FLFBLS=num,FLFCDP=REWIND/UNLOAD/LEAVE,FLFCOD=SYSTEM/ASCII/EBCDIC,SPLMOD=NONE/SERIAL/PARALLEL,SPLNBR=num,SPLSIZ=num,ORGORG=SEQ/PS/EDS/ESDS/KDS/KSDS/RDS/RRDS/LDS,ORGRCF=VAR/FIX/UND/TXT/DLM/VB/FB/V2B-XBE/V4B-XBE/V4A-ICL/V4E-ICL/V2B-ILE/V2B-IBE/V4B-IBE,ORGRCL=num,ORGBLS=num,ORGPRN=NONE/ASA/MCC,ORGRCD=NONE/LF-ASCII/CR-ASCII/NL-ASCII/CRLF-ASCII/LF-EBCDIC/CR-EBCDIC/NL-EBCDIC/CRLF-EBCDIC,ORGSYS=DOS/WIN/UNIX/MAC/ZOS/VSE/ZVM/AIX/ZLINUX/AS400/OS2/HPUX/MPE/SUNOS/SOLARIS/BS2000/SINIX/VMS/NONSTOP/UNISYS/OFS/DUX/AMIGA/FL5,DEVICE=FILE/DISK/TAPE/FLOPPY/STREAMER/USER,NONHDR,NONFIL,COMENT='str',PASSWD='bin'/DEFAULT,KMELIB='str',KMEFUC='str',KMEPAR='bin',EXTCMP/EXK20='str',EXTDCO/EXD20='str',ACSTIM=num,MODTIM=num,ATTRIB(),BLKORI,PRISPC=num,SECSPC=num,VOLSER='str',VOLUNT='str',DATCLS='str',MGMCLS='str',STOCLS='str',DSPSTA=NEW/SHR/MOD/OLD,DSPNRM=CATALOG/CATLG/DELETE/KEEP/UNCATALOG/UNCATLG,DSPABO=CATALOG/CATLG/DELETE/KEEP/UNCATALOG/UNCATLG,KEYPOS=num,KEYLEN=num,SECINF=YES/NO/IGNORE/MEMBER,NOPATH,PREPRO[()...],POSTPRO/PSTPRO[()...])
This object defines the FLAM4 write operation for files. This method writes each data list entry as a record to a FLAMFILE of version 4 or older. It uses the FLAM4 record interface to write members to a FLAMFILE. The parameters below are explained in detail by the FLAM command of FLCL.
STRING: NAME/FLAMFILE/FILE='str'/STREAM/DUMMY - Name/URL of FLAMFILE to write [auto]
STREAM - Read from stdin or write to stdoutDUMMY - Read EOF or write nothingSTRING: MEMBER='str' - Rename the member in the FLAMFILESWITCH: REMAIN - Remain existing files (don't overwrite) [FALSE]SWITCH: NOMKDIR - Don't create path if path not exists [FALSE]SWITCH: APPEND - Append the member to this FLAMFILE (not useful with encryption) [FALSE]NUMBER: CMPMOD=CX7/CX8/VR8/ADC/NDC - FLAM Mode [ADC]
CX7 - Compression encoding as printable charactersCX8 - Compression encoding as binary dataVR8 - Enhanced compression encoding as binary dataADC - Advanced Data CompressionNDC - No data compressionNUMBER: ENCMOD=OFF/AES/FLAMENC - Encryption Mode [NONE]
OFF - Disable encryptionAES - AES encryptionFLAMENC - FLAM encryptionNUMBER: BLKMOD=UNBLOCKED/BLOCKED - Block mode [unblocked]
UNBLOCKED - Each segment starts on new record (VSAM KSDS only)BLOCKED - Segment can start within a record (recommended)NUMBER: MAXBUF=num - Maximum buffer size for FLAM matrix [65336]NUMBER: MAXREC=num - Maximum amount of records per matrix [255]NUMBER: CLIMIT=num - Minimum compression in per cent (0 no Limit)[0]NUMBER: FLFORG=SEQ/PS/EDS/ESDS/KDS/KSDS/RDS/RRDS/LDS - Organization of the FLAMFILE [SEQ]
SEQ - Sequential access [DEFAULT]PS - Sequential access [DEFAULT]EDS - Entry data set (VSAM-ESDS)ESDS - Entry data set (VSAM-ESDS)KDS - Keyed data set (VSAM-KSDS)KSDS - Keyed data set (VSAM-KSDS)RDS - Relative data set (VSAM-RRDS)RRDS - Relative data set (VSAM-RRDS)LDS - Linear data set (VSAM-LDS)NUMBER: FLFRCF=VAR/FIX/UND/TXT/DLM/VB/FB/V2B-XBE/V4B-XBE/V4A-ICL/V4E-ICL/V2B-ILE/V2B-IBE/V4B-IBE - Record format for the FLAMFILE [FIX]
VAR - VariableFIX - FixUND - UndefinedTXT - Text/StreamDLM - Stream with special delimiterVB - Variable blockedFB - Fix blockedV2B-XBE - Variable 2 byte length field without the length in big endianV4B-XBE - Variable 4 byte length field without the length in big endianV4A-ICL - Variable 4 byte length field in ASCII inclusive the lengthV4E-ICL - Variable 4 byte length field in EBCDIC inclusive the lengthV2B-ILE - Variable 2 byte length field inclusive the length in little endianV2B-IBE - Variable 2 byte length field inclusive the length in big endianV4B-IBE - Variable 4 byte length field inclusive the length in big endianNUMBER: FLFRCL=num - Record length for the FLAMFILE [512]NUMBER: FLFRCD=NONE/LF-ASCII/CR-ASCII/NL-ASCII/CRLF-ASCII/LF-EBCDIC/CR-EBCDIC/NL-EBCDIC/CRLF-EBCDIC - Record delimiter for the FLAMFILE (only for CX7)
NONE - No record separationLF-ASCII - Record separation with line feed in ASCII (0x0A)CR-ASCII - Record separation with carriage return in ASCII (0x0D)NL-ASCII - Record separation with new line in ASCII (0x85)CRLF-ASCII - Record separation with carriage return line feed in ASCII (0x0D0A)LF-EBCDIC - Record separation with line feed in EBCDIC (0x25)CR-EBCDIC - Record separation with carriage return in EBCDIC (0x0D)NL-EBCDIC - Record separation with new line in EBCDIC (0x15)CRLF-EBCDIC - Record separation with carriage return line feed in EBCDIC (0x0D25)NUMBER: FLFBLS=num - Block size for the FLAMFILE (mainly host related)NUMBER: FLFCDP=REWIND/UNLOAD/LEAVE - Close disposition for the FLAMFILE (mainly host related)
REWIND - Rewind the tape to the beginningUNLOAD - Rewind the tape and unload itLEAVE - Do not rewindNUMBER: FLFCOD=SYSTEM/ASCII/EBCDIC - Character set for string encoding in the FLAMFILE [SYSTEM]
SYSTEM - System specific encodingASCII - String encoding in ASCIIEBCDIC - String encoding in EBCDICNUMBER: SPLMOD=NONE/SERIAL/PARALLEL - Split mode [NONE] (only for z/OS)
NONE - No splitting (default)SERIAL - Serial splitting (after 1-4096 Megabyte)PARALLEL - Parallel splitting (in 2, 3 or 4 files)NUMBER: SPLNBR=num - Split number (2-4 files for parallel splitting (only for z/OS)) [4]NUMBER: SPLSIZ=num - Split size (1-4096 MB for serial splitting (only for z/OS)) [100]NUMBER: ORGORG=SEQ/PS/EDS/ESDS/KDS/KSDS/RDS/RRDS/LDS - Organization of the original file [from origin]
SEQ - Sequential access [DEFAULT]PS - Sequential access [DEFAULT]EDS - Entry data set (VSAM-ESDS)ESDS - Entry data set (VSAM-ESDS)KDS - Keyed data set (VSAM-KSDS)KSDS - Keyed data set (VSAM-KSDS)RDS - Relative data set (VSAM-RRDS)RRDS - Relative data set (VSAM-RRDS)LDS - Linear data set (VSAM-LDS)NUMBER: ORGRCF=VAR/FIX/UND/TXT/DLM/VB/FB/V2B-XBE/V4B-XBE/V4A-ICL/V4E-ICL/V2B-ILE/V2B-IBE/V4B-IBE - Record format for the original file [from origin]
VAR - VariableFIX - FixUND - UndefinedTXT - Text/StreamDLM - Stream with special delimiterVB - Variable blockedFB - Fix blockedV2B-XBE - Variable 2 byte length field without the length in big endianV4B-XBE - Variable 4 byte length field without the length in big endianV4A-ICL - Variable 4 byte length field in ASCII inclusive the lengthV4E-ICL - Variable 4 byte length field in EBCDIC inclusive the lengthV2B-ILE - Variable 2 byte length field inclusive the length in little endianV2B-IBE - Variable 2 byte length field inclusive the length in big endianV4B-IBE - Variable 4 byte length field inclusive the length in big endianNUMBER: ORGRCL=num - Record length for the original file [from origin]NUMBER: ORGBLS=num - Block size for the original file [from origin]NUMBER: ORGRCD=NONE/LF-ASCII/CR-ASCII/NL-ASCII/CRLF-ASCII/LF-EBCDIC/CR-EBCDIC/NL-EBCDIC/CRLF-EBCDIC - Record delimiter for the original file [from origin]
NONE - No record separationLF-ASCII - Record separation with line feed in ASCII (0x0A)CR-ASCII - Record separation with carriage return in ASCII (0x0D)NL-ASCII - Record separation with new line in ASCII (0x85)CRLF-ASCII - Record separation with carriage return line feed in ASCII (0x0D0A)LF-EBCDIC - Record separation with line feed in EBCDIC (0x25)CR-EBCDIC - Record separation with carriage return in EBCDIC (0x0D)NL-EBCDIC - Record separation with new line in EBCDIC (0x15)CRLF-EBCDIC - Record separation with carriage return line feed in EBCDIC (0x0D25)STRING: ORGSYS=DOS/WIN/UNIX/MAC/ZOS/VSE/ZVM/AIX/ZLINUX/AS400/OS2/HPUX/MPE/SUNOS/SOLARIS/BS2000/SINIX/VMS/NONSTOP/UNISYS/OFS/DUX/AMIGA/FL5 - Operating system for the original file [from origin]
DOS - MS DOSWIN - MS WindowsUNIX - UNIX (general)MAC - Apple MAC OSZOS - IBM z/OSVSE - IBM z/VSEZVM - IBM z/VMAIX - IBM AIX (Power)ZLINUX - IBM z/LinuxAS400 - IBM AS400 / iSeriesOS2 - IBM OS/2HPUX - HP-UXMPE - HP MPESUNOS - SUN OSSOLARIS - SUN / Open SolarisBS2000 - Siemens BS2000 OSDSINIX - Siemens Nixdorf UnixVMS - HP Open VMS / DEC-VMSNONSTOP - HP Non Stop / TandemUNISYS - UNISYSOFS - DEC OFS1DUX - DEC UNIXAMIGA - Amiga / MotorolaFL5 - FLAM 5 component (FLUC)NUMBER: DEVICE=FILE/DISK/TAPE/FLOPPY/STREAMER/USER - Device used to store the FLAMFILE [FLATFILE]
FILE - Write to a file (equal to disk)DISK - Write to a disk (equal to file)TAPE - Write to a tapeFLOPPY - Write to a floppySTREAMER - Write to a streamer tapeUSER - Use user IOSWITCH: NONHDR - Switch to write no file header [FALSE]SWITCH: NONFIL - Switch to write no file name in file header [FALSE]STRING: COMENT='str' - Comment for the member in the FLAMFILE [internal use]STRING: PASSWD='bin'/DEFAULT - Passphrase to encrypt the FLAMFILE ['']
DEFAULT - FLAM4 default passwordSTRING: KMELIB='str' - Library name for FKME ['']STRING: KMEFUC='str' - Function name of FKME ['']STRING: KMEPAR='bin' - Parameter for the call of FKME ['']STRING: EXTCMP/EXK20='str' - Name of user exit for compressionSTRING: EXTDCO/EXD20='str' - Name of user exit for decompressionNUMBER: ACSTIM=num - Define the last access time for this fileNUMBER: MODTIM=num - Define the last modification time for this fileSWITCH: BLKORI - Enforce block-oriented write of records (32752) with FLAM4NUMBER: PRISPC=num - Primary size in megabytesNUMBER: SECSPC=num - Secondary size in megabytesSTRING: VOLSER='str' - Volume serial numberSTRING: VOLUNT='str' - Volume unitSTRING: DATCLS='str' - Data classSTRING: MGMCLS='str' - Management classSTRING: STOCLS='str' - Storage classNUMBER: DSPSTA=NEW/SHR/MOD/OLD - Disposition status
NEW - Disposition status NEW (brand new file)SHR - Disposition status SHR (read exiting file)MOD - Disposition status MOD (append/modify file)OLD - Disposition status OLD (overwrite existing file)NUMBER: DSPNRM=CATALOG/CATLG/DELETE/KEEP/UNCATALOG/UNCATLG - Close disposition for normal end
CATALOG - Close disposition catalogCATLG - Close disposition catalogDELETE - Close disposition deleteKEEP - Close disposition keepUNCATALOG - Close disposition uncatalogUNCATLG - Close disposition uncatalogNUMBER: DSPABO=CATALOG/CATLG/DELETE/KEEP/UNCATALOG/UNCATLG - Close disposition for abnormal end
CATALOG - Close disposition catalogCATLG - Close disposition catalogDELETE - Close disposition deleteKEEP - Close disposition keepUNCATALOG - Close disposition uncatalogUNCATLG - Close disposition uncatalogNUMBER: KEYPOS=num - Key position (>=1) for index/key sequential data sets [1]NUMBER: KEYLEN=num - Key length (>=1) for index/key sequential data sets [8]NUMBER: SECINF=YES/NO/IGNORE/MEMBER - Define handling of secure information
YES - Create secure information at compressionNO - Do not store any additional secure informationIGNORE - Ignore any security violations on decompressionMEMBER - Only member-specific security information is verifiedSWITCH: NOPATH - Exclude directory path of the original file in the compressed data [FALSE]