#### FL4

#### Synopsis

    HELP:   Write a FLAMFILE record-oriented
    TYPE:   OBJECT
    SYNTAX: FL4(NET.{},NAME/FLAMFILE/FILE='str'/STREAM/DUMMY,MEMBER='str',REMOVE,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[()...])

#### Description

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.

#### Arguments

- `STRING: NAME/FLAMFILE/FILE='str'/STREAM/DUMMY - Name/URL of FLAMFILE to write [auto]`
  - `STREAM - Read from stdin or write to stdout`
  - `DUMMY - Read EOF or write nothing`
- `STRING: MEMBER='str' - Rename the member in the FLAMFILE`
- `SWITCH: 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 characters`
  - `CX8 - Compression encoding as binary data`
  - `VR8 - Enhanced compression encoding as binary data`
  - `ADC - Advanced Data Compression`
  - `NDC - No data compression`
- `NUMBER: ENCMOD=OFF/AES/FLAMENC - Encryption Mode [NONE]`
  - `OFF - Disable encryption`
  - `AES - AES encryption`
  - `FLAMENC - FLAM encryption`
- `NUMBER: 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 - Variable`
  - `FIX - Fix`
  - `UND - Undefined`
  - `TXT - Text/Stream`
  - `DLM - Stream with special delimiter`
  - `VB - Variable blocked`
  - `FB - Fix blocked`
  - `V2B-XBE - Variable 2 byte length field without the length in big endian`
  - `V4B-XBE - Variable 4 byte length field without the length in big endian`
  - `V4A-ICL - Variable 4 byte length field in ASCII inclusive the length`
  - `V4E-ICL - Variable 4 byte length field in EBCDIC inclusive the length`
  - `V2B-ILE - Variable 2 byte length field inclusive the length in little endian`
  - `V2B-IBE - Variable 2 byte length field inclusive the length in big endian`
  - `V4B-IBE - Variable 4 byte length field inclusive the length in big endian`
- `NUMBER: 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 separation`
  - `LF-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 beginning`
  - `UNLOAD - Rewind the tape and unload it`
  - `LEAVE - Do not rewind`
- `NUMBER: FLFCOD=SYSTEM/ASCII/EBCDIC - Character set for string encoding in the FLAMFILE [SYSTEM]`
  - `SYSTEM - System specific encoding`
  - `ASCII - String encoding in ASCII`
  - `EBCDIC - String encoding in EBCDIC`
- `NUMBER: 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 - Variable`
  - `FIX - Fix`
  - `UND - Undefined`
  - `TXT - Text/Stream`
  - `DLM - Stream with special delimiter`
  - `VB - Variable blocked`
  - `FB - Fix blocked`
  - `V2B-XBE - Variable 2 byte length field without the length in big endian`
  - `V4B-XBE - Variable 4 byte length field without the length in big endian`
  - `V4A-ICL - Variable 4 byte length field in ASCII inclusive the length`
  - `V4E-ICL - Variable 4 byte length field in EBCDIC inclusive the length`
  - `V2B-ILE - Variable 2 byte length field inclusive the length in little endian`
  - `V2B-IBE - Variable 2 byte length field inclusive the length in big endian`
  - `V4B-IBE - Variable 4 byte length field inclusive the length in big endian`
- `NUMBER: 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 separation`
  - `LF-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 DOS`
  - `WIN - MS Windows`
  - `UNIX - UNIX (general)`
  - `MAC - Apple MAC OS`
  - `ZOS - IBM z/OS`
  - `VSE - IBM z/VSE`
  - `ZVM - IBM z/VM`
  - `AIX - IBM AIX (Power)`
  - `ZLINUX - IBM z/Linux`
  - `AS400 - IBM AS400 / iSeries`
  - `OS2 - IBM OS/2`
  - `HPUX - HP-UX`
  - `MPE - HP MPE`
  - `SUNOS - SUN OS`
  - `SOLARIS - SUN / Open Solaris`
  - `BS2000 - Siemens BS2000 OSD`
  - `SINIX - Siemens Nixdorf Unix`
  - `VMS - HP Open VMS / DEC-VMS`
  - `NONSTOP - HP Non Stop / Tandem`
  - `UNISYS - UNISYS`
  - `OFS - DEC OFS1`
  - `DUX - DEC UNIX`
  - `AMIGA - Amiga / Motorola`
  - `FL5 - 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 tape`
  - `FLOPPY - Write to a floppy`
  - `STREAMER - Write to a streamer tape`
  - `USER - Use user IO`
- `SWITCH: 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 password`
- `STRING: 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 compression`
- `STRING: EXTDCO/EXD20='str' - Name of user exit for decompression`
- `NUMBER: ACSTIM=num - Define the last access time for this file`
- `NUMBER: MODTIM=num - Define the last modification time for this file`
- `SWITCH: BLKORI - Enforce block-oriented write of records (32752) with FLAM4`
- `NUMBER: PRISPC=num - Primary size in megabytes`
- `NUMBER: SECSPC=num - Secondary size in megabytes`
- `STRING: VOLSER='str' - Volume serial number`
- `STRING: VOLUNT='str' - Volume unit`
- `STRING: DATCLS='str' - Data class`
- `STRING: MGMCLS='str' - Management class`
- `STRING: STOCLS='str' - Storage class`
- `NUMBER: 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 catalog`
  - `CATLG - Close disposition catalog`
  - `DELETE - Close disposition delete`
  - `KEEP - Close disposition keep`
  - `UNCATALOG - Close disposition uncatalog`
  - `UNCATLG - Close disposition uncatalog`
- `NUMBER: DSPABO=CATALOG/CATLG/DELETE/KEEP/UNCATALOG/UNCATLG - Close disposition for abnormal end`
  - `CATALOG - Close disposition catalog`
  - `CATLG - Close disposition catalog`
  - `DELETE - Close disposition delete`
  - `KEEP - Close disposition keep`
  - `UNCATALOG - Close disposition uncatalog`
  - `UNCATLG - Close disposition uncatalog`
- `NUMBER: 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 compression`
  - `NO - Do not store any additional secure information`
  - `IGNORE - Ignore any security violations on decompression`
  - `MEMBER - Only member-specific security information is verified`
- `SWITCH: NOPATH - Exclude directory path of the original file in the compressed data [FALSE]`