Defining files using BAS

To create a file definition:

  1. Issue the create primary (CREate) or line (CRE) action command from the FILEDEF view.
  2. Fill in the fields on the first file definition panel (see Figure 58):
    Figure 58. Creating a file definition - Page 1
     COMMAND ===>
      Name          ===> EYUFIL08     Version  ===> 0
      Description   ===> Payroll Updates - Local
      RESGROUP      ===>
      User Data     ===>
     
     VSAM PARAMETERS
      Dsname                          Data set name
                    ===> PAYROLL.EUTL3
                    ===>
     
      Password      ===>              User access password
      Rlsaccess     ===> NO           CICS opens files in RLS mode (YES,NO)
      Lsrpoolid     ===> 1            Local shared resource pool (1-8, NONE, blank)
      Readintegrity ===> UNCOMMITTED  Read level (UNCOMMITTED,CONSISTENT,REPEATABLE)
      Dsnsharing    ===> ALLREQS      Dataset sharing (ALLREQS,MODIFYREQS)
      Strings       ===> 30           Concurrent file requests (1 - 255, blank)
      Nsrgroup      ===>              Group name for VSAM data set
     
     Press ENTER to update FILEDEF.
     Press UP or DOWN to view other screens
     Enter END or CANCEL to cancel wthout creating.
  3. To add the file definition to the data repository, press Enter. To continue creating a file definition, issue the DOWN command. Otherwise, issue one of the commands available from this panel.
  4. Fill in the fields on the second file definition panel (see Figure 59):
    Figure 59. Creating a file definition - Page 2
     COMMAND ===>
      Name              EYUFIL08    Version  ===> 0
     
     REMOTE ATTRIBUTES
      Remotename   ===>             Remote file name
      RemoteSystem ===>             Connection name to remote system
     REMOTE AND CFDATATABLE PARAMETERS
      Recordsize   ===>             Record size (1 - 32767, blank)
      Keylength    ===>             Key length (1 - 255, blank)
                                               (1 - 16 for CF Tables)
     INITIAL STATUS
      Status       ===> ENABLED     Status (ENABLED,DISABLED,UNENABLED)
      Opentime     ===> FIRSTREF    Open time (FIRSTREF, STARTUP)
      Disposition  ===> SHARE       File disposition (SHARE, OLD)
     NSR BUFFERS
      Databuffers  ===> 31          Number of data buffers (2-32767, blank)
      Indexbuffers ===> 30          Number of index buffers (1-32767, blank)
     
     Press ENTER to update FILEDEF.
     Enter UP or DOWN to view other screens
     Enter END or CANCEL to cancel without updating.
  5. To add the file definition to the data repository, press Enter. To continue creating a file definition, issue the DOWN command. Otherwise, issue one of the commands available from this panel.
  6. Fill in the fields in the third file definition panel (see Figure 60):
    Figure 60. Creating a file definition - Page 3
    COMMAND ===>
     Name                  EYUFIL08    Version  ===> 0
     
     DATATABLE PARAMETERS
      Table        ===> NO          Data table type (NO, CICS, USER, CF)
      Maxnumrecs   ===> NOLIMIT     Max entries in data table ...
                                        (NOLIMIT or 1-99,999,999)
     CFDATATABLE PARAMETERS
      Cfdtpool     ===>             Name of coupling facility data table pool
      Tablename    ===>             Data table name
      Updatemodel  ===> LOCKING     Update model (LOCKING or CONTENTION)
      Loadtype     ===> NO          Whether file loads table (YES or NO)
     RECORD FORMAT
      Recordformat ===> VARIABLE    Record format (VARIABLE, FIXED)
     
    Press ENTER to update FILEDEF.
    Enter UP or DOWN to view other screens
    Enter END or CANCEL to cancel without updating.
  7. To add the file definition to the data repository, press Enter. To continue creating a file definition, issue the DOWN command. Otherwise, issue one of the commands available from this panel.
  8. Fill in the fields on the fourth file definition panel (see Figure 61):
    Figure 61. Creating a file definition - Page 4
    COMMAND ===>
     Name                  EYUFIL08    Version0
     
     OPERATIONS
      Add          ===> YES         Records can be added to file (YES,NO)
      Browse       ===> YES         Records retrieved sequentially (YES,NO)
      Delete       ===> YES         Records can be deleted (YES,NO)
      Read         ===> YES         Records can be read (YES, NO)
      Update       ===> YES         Records can be updated (YES,NO)
     AUTO JOURNALLING
      Journal      ===>             Journal number (NO, 1-99, blank)
      Jnlread      ===> NONE        Read ops in jrnl (NONE,ALL,READONLY,UPDATEONLY)
      Jnlsyncread  ===> NO          Auto journaling for read (YES,NO)
      Jnlupdate    ===> NO          Rewrite/Delete oprs record on jrnl (YES,NO)
      Jnladd       ===> NONE        Add ops recorded on jrnl(NONE,AFTER,ALL,BEFORE)
      Jnlsyncwrite ===> YES         Auto journaling for write (YES,NO)
     
    Press ENTER to update FILEDEF.
    Enter UP or DOWN to view other screens
    Enter END or CANCEL to cancel without updating.
  9. To add the file definition to the data repository, press Enter. To continue creating a file definition, issue the DOWN command. Otherwise, issue one of the commands available from this panel.
  10. Fill in the fields on the fifth file definition panel (see Figure 62):
    Figure 62. Creating a file definition - Page 5
    COMMAND ===>
     Name                  EYUFIL08    Version  ===> 0
     
     
     
     RECOVERY PARAMETERS
      Recovery        ===> NONE        Type of recovery (NONE,ALL,BACKOUTONLY)
      Fwdrecovlog     ===>             Journal Name used for recovery (NO, 1-99,
                                       blank)
      Backuptype      ===> STATIC      CICS VSAM file backup type (STATIC,DYNAMIC)
     SECURITY
      Ressecnum       ===>             Resource security value (0-24,PUBLIC,blank)
     
     
     
     
    Press ENTER to update FILEDEF.
    Enter UP or DOWN to view other screens
    Enter END or CANCEL to cancel without updating.
  11. To continue creating a file definition:
  12. Fill in the fields on the sixth file definition panel (see Figure 63):
    Figure 63. Creating a file definition - Page 6
     COMMAND ===>
      Name                  EYUFIL08    Version
     
      File Open        ===> Y           Open file at startup (Y, N, blank)
      File Enabled     ===> Y           Enable file (Y, N, blank)
      File Type        ===> K           Type of file (E, K, R, A, blank)
      File Access      ===> R           Access method (R, U, O, blank)
      Base File Name   ===>             Alternate index base file
      Key Number       ===>             Access key for base file (1-99, blank)
      Min Record Len   ===>             Minimum record length (1-4090, blank)
      Max Record Len   ===>             Maximum record length (1-32767, blank)
      CI Size          ===>             Control interval size (512-4096, blank)
      Ext File Mgr     ===> N           Use external file manager (Y, N, blank)
     
      FSEG Def Name    ===>             File key segment definition
      FSEG Def Ver     ===>             File key segment def version (1-15, blank)
     
     Press ENTER to update FILEDEF.
     Enter UP or DOWN to view other screens
     Enter END or CANCEL to cancel without updating.
  13. To add the file definition to the data repository, press Enter. Otherwise, issue one of the other commands available from this panel.

Related concepts
File resource definitions
CICS Resource Definition Guide
CICS System Programming Reference
Related tasks
Accessing BAS file definitions
Working with the FILEDEF view
Installing BAS file definitions
CICS Resource Definition Guide
CICS System Programming Reference
Related reference
File definition attributes
[[ Contents Previous Page | Next Page Index ]]