NAF - Objects - Function 31

#### Search Results

Search

# NAF - Objects - Function 31

When you invoke this function, the Objects window appears:

    Time 13:00:45        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                          +-------------Objects 7/411--------------+
           Administration                 !                                        !
                                          !   1     User Profile                   !
           10 Reports/Queues              !   2     Logical Printer                !
           11 Devices                     !   3     Allocation Table               !
           12 Abstracts                   !   4     Printer                        !
           13 Applications                !   5     Header Page                    !
           14 Change Spool File           !   6     Application                    !
                                          !   7     Cluster                        !
                                          !   8     NTCC Table                     !
           Maintenance                    !   9     Calendar                       !
                                          !                                        !
           30 Spool File Properties       !                                        !
           31 Objects                     !                                        !
           32 Mass Update                 !   .     Exit                           !
           33 Hardcopy Allocations        !                                        !
           34 Transfer Objects            !   Command / _  /                       !
                                          +----------------------------------------+
     Enter command, or press a PF-key.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

The Cluster function can be deactivated.

## Deleting an Object

In general, if you delete an object from the spool file, only the object itself is deleted, not its possible references in other objects.

#### Example:

If you delete a logical printer profile from the spool file, possible references of this printer profile in user profiles are not deleted. If you want to also delete the printer profile in some or all referenced user profiles, you need to modify the user profile(s) involved accordingly.

Use the Cross-Reference Function 20 (Information section) to find out in which objects a given object is referenced.

This section covers the following topics:

User Profile - Function 31.1
Logical Printer - Function 31.2
Allocation Table - Function 31.3
Printer - Function 31.4
Header Page - Function 31.5
Applications - Function 31.6
Cluster - Function 31.7
NTCC Table - Function 31.8
Calendar - Function 31.9
Message Header - Function 31.A

## NAF - User Profile - Function 31.1

A user profile contains information on the logical printers to be used. For each `WRITE (rep)` statement a logical printer is defined. For example, if the statement `WRITE (2)` is executed, the second logical printer contained in the currently active user profile will be used to describe the characteristics of the reports produced by the `WRITE (2)` statement.

You can also define a logical printer for the hardcopy function.

This feature enables a user to select a printer which is convenient (that is, a printer which is located near the user's terminal, or a printer into which a special form has been inserted).

Below is information on:

- Invoking User Profile

- Selecting a User Profile from a List

- Maintaining a User Profile

### Invoking User Profile

When you invoke this function, the User Profile window appears:

    Time 10:02:37        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                         +---------- User Profile 7/411 _---------+
          Administration                 !                                        !
                                         !  Enter name of                         !
          10 Reports / Queues            !                                        !
          11 Devices                     !       User Profile                     !
          12 Abstracts                   !                                        !
          13 Applications                !  or                                    !
          14 Change Spool File           !                                        !
                                         !      *    for Selection                !
          Maintenance                    !                                        !
                                         !      ?    for Help                     !
          30 Spool File Properties       !                                        !
          31 Objects                     !      .    for End                      !
          32 Mass Update                 !                                        !
          33 Hardcopy Allocations        !      -------------------------         !
          34 Transfer Objects            !      / ________ /                      !
                                         !                                        !
                                         +----------------------------------------+
    Enter values.
    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

In this window, you can specify the name of an existing user profile, select a profile from a list of profiles available or add a new profile to the spool file.

### Selecting a User Profile from a List

To select a user profile from a list, enter one of the following:

- a partly-qualified name (e.g. `CA*` to list all user profiles starting alphabetically from `CA`),

- an asterisk (*) to list all user profiles in the `NATSPOOL` system.

A list of user profiles is then shown in a window.

    Time 10:14:38        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                           M e n u                     File 7/411
                                          +------------Select with CA*-------------+
           Administration                 !  New start value ......... _________   !
                                          !  -----------------------------------   !
           10 Reports / Queues            !  Fl Cm  Name        Fl Cm  Name        !
           11 Devices                     !  -- --  ---------   -- --  ---------   !
           12 Abstracts                   !      _  CAYIMS          _  CAYIMS01    !
           13 Applications                !      _  CAYPRINT        _  CYTEST      !
           14 Change Spool File           !      _  DWI010          _  GRE10       !
                                          !      _  HBNPROF         _  HHIUPF01    !
           Maintenance                    !      _  HUGO            _  NOM         !
                                          !      _  REC             _  RRI         !
           30 Spool File Properties       !      _  RRICICS         _  SAG         !
           31 Objects                     !      _  SAGILQ          _  SAG00001    !
           32 Mass Update                 !      _  SET1            _  SET2        !
           33 Hardcopy Allocations        !      _  TMA             _  URANIMS     !
           34 Transfer Objects            !                                        !
                                          !                                        !
                                          +----------------------------------------+
     Mark on selection list.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                     --                           Canc

The user profile which was used for the initialization of the current Natural session is highlighted in the window.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`C` | Copy user profile.
`D` | Delete user profile.
`R` | Rename user profile.
`.` | Exit function.
`X` or any other character | Display user profile for modification or deletion, see below.

### Maintaining a User Profile

If the specified user profile exists, it is displayed. You can modify the list of allocated logical printers (LPFs) or delete the whole user profile.

Note
If you specify a name that does not yet exist, you can add a new user profile. In this case, the `Delete` option is not provided in the window.

    Time 10:09:47        *** Natural Spool Administration ***     Date 2022-04-06
    User SAG                            M e n u                   File 7/411
       +---------------------------- User Profile -------------------------------+
       !   Modify                SET1                   Delete (Y/N)         N   !
       !   -------------------------------------------------------------------   !
       !   Owner (Y/N) N        Mark for selection of existing log. printers _   !
       !   - -----------------------------------------------------------------   !
       !   Mk. No. LPF Name Mk. No. LPF Name Mk. No. LPF Name Mk. No. LPF Name   !
       !    _  1   PROF3___  _  2   PROF2___  _  3   PROF1___  _  4   NOMPRT01   !
       !    _  5   ________  _  6   ________  _  7   ________  _  8   ________   !
       !    _  9   ________  _  10  ________  _  11  ________  _  12  ________   !
       !    _  13  ________  _  14  ________  _  15  ________  _  16  ________   !
       !    _  17  ________  _  18  ________  _  19  ________  _  20  ________   !
       !    _  21  ________  _  22  ________  _  23  ________  _  24  ________   !
       !    _  25  ________  _  26  ________  _  27  ________  _  28  ________   !
       !    _  29  ________  _  30  ________  _  31  ________  _  HC  ________   !
       !   -------------------------------------------------------------------   !
       !   Notes                                                                 !
       !   ________________________________________________________________      !
       +-------------------------------------------------------------------------+
     Enter name or mark logical printer.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

The window prompts for a list of names of logical printers to be associated with the user profile. Up to 31 logical printer names may be entered, since this is the maximum number of logical printers which can be specified in a single user profile.

If you mark the field for selection of existing logical printers, a list of all available logical printers is displayed, where the desired logical printers may be selected by number. The logical printer names are positional. If, for example, the first and third elements of the user profile are defined, only the statements `WRITE (1)` and `WRITE (3)` will be valid. The statement `WRITE (2)`, however, would receive error message `NAT1573` (logical printer not found on spool file).

In the `HC` field, you can define a logical printer for the hardcopy function.

#### Example:

The user profile `UPFSTART` contains the following entries:

1: `LDR4711`
2: `LDR1805`
3: `LRZ`
HC: `LHCOP`

The positions 4 to 31 are empty.

These definitions result in the following:

When `WRITE (1)` is executed, the logical printer `LDR4711` is used. When `WRITE (2)` is executed, the logical printer `LDR1805` is used. When `WRITE (3)` is executed, the logical printer `LRZ` is used. When `%H` is executed, the logical printer `LHCOP` is used.

The prerequisite, however, is that the `PRINT` parameter was dynamically defined, or that the `NTPRINT` macro was defined in the Natural parameter module for at least 3 printers:

    NTPRINT (1-3),AM=NAF

If a value smaller than 3 was defined, the corresponding entries in the user profile are ignored.

## NAF - Logical Printer - Function 31.2

A logical printer (LPF) defines the attributes that are to be applied to a report.

Using the `DEFINE PRINTER` statement, it is possible to modify the assignment - independent of the settings used during initialization or logon.

If you have modified the assignment using the `DEFINE PRINTER` statement (e.g. you have specified a new value for `OUTPUT`), the new assignment is not automatically reset at program end.

It is valid until a new assignment is made using the `DEFINE PRINTER` statement or until a new initialization (via logon) occurs (only when using Natural Security).

Print output can also be forwarded to other spool systems. This is controlled by a logical printer.

This section covers the following topics:

- Invoking Logical Printer

- Selecting a Logical Printer from a List

- Maintaining a Logical Printer

### Invoking Logical Printer

When you invoke this function, the Logical Printer window appears:

    Time 10:18:01        *** Natural Spool Administration ***      Date 2022-04-06
     User SAG                            M e n u                    File 7/411
                                           +------- Logical Printer 7/411 ----------+
            Administration                 !                                        !
                                           !  Enter name of                         !
            10 Reports / Queues            !                                        !
            11 Devices                     !       Logical Printer                  !
            12 Abstracts                   !                                        !
            13 Applications                !  or                                    !
            14 Change Spool File           !                                        !
                                           !      *    for Selection                !
            Maintenance                    !                                        !
                                           !      ?    for Help                     !
            30 Spool File Properties       !                                        !
            31 Objects                     !      .    for End                      !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !      -------------------------         !
            34 Transfer Objects            !      / ________ /                      !
                                           !                                        !
                                           +----------------------------------------+
      Enter values.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

In this window, you can specify the name of an existing logical printer, select a logical printer from a list of available printers or add a new logical printer to the spool file.

### Selecting a Logical Printer from a List

To select a logical printer from a list, in the selection window, enter

1. A partly-qualified name (e.g. `D*` to list all logical printers starting alphabetically from D),

2. An asterisk (*) to list all logical printers in the `NATSPOOL` system.

A list of logical printers is then shown in a window.

    Time 10:29:11        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                             M e n u                   File 7/411
                                          +-------------Select with *--------------+
           Administration                 !  New start value ......... _________   !
                                          !  -----------------------------------   !
           10 Reports / Queues            !  Fl Cm  Name        Fl Cm  Name        !
           11 Devices                     !  -- --  ---------   -- --  ---------   !
           12 Abstracts                   !   5  _  -------      5  _  ---0        !
           13 Applications                !   5  _  ---1         5  _  ---2        !
           14 Change Spool File           !   5  _  ---4         5  _  ---6        !
                                          !   5  _  ---8         5  _  --23        !
           Maintenance                    !      _  #RRI            _  BPM-----    !
                                          !      _  BRU1            _  CMPRT08     !
           30 Spool File Properties       !   6  _  DAELC107        _  DAEN0526    !
           31 Objects                     !      _  DAEN0541        _  DAEPRT10    !
           32 Mass Update                 !      _  DAEPRT12        _  DAEPRT13    !
           33 Hardcopy Allocations        !      _  DAEPRT45     6  _  FRIPRT17    !
           34 Transfer Objects            !      _  GRE10        1  _  H-------    !
                                          !   8  _  HHI-----        _  HHILPF      !
                                          +----------------------------------------+
     Mark on selection list.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                     --   +                       Canc

The logical printers which were used for the initialization of the current Natural session are highlighted in the window.

The `Fl` (flag) column indicates the usage of the logical printer. For the possible values in this column, see the online help.

Names containing a hyphen (-) are created for hardcopy allocation by using a mask to build up the corresponding name. See the spool file options.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`C` | Copy logical printer.
`D` | Delete logical printer.
`R` | Rename logical printer.
`.` | Exit function.
`X` or any other character | Display logical printer for modification or deletion, see below.

### Maintaining a Logical Printer

If the specified logical printer exists, it is displayed. You can modify the individual parameters or delete the whole logical printer.

Note
If you specify a name that does not yet exist, you can add a new logical printer. In this case, the Delete option is not provided in the window.

    Time 09:59:08        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
       +---------------------------- Logical Printer ----------------------------+ +
       !   Modify                PROF1                  Delete (Y/N)         N   ! !
       !   -------------------------------------------------------------------   ! !
       !   Mark for selection of existing allocations (Destination/Form)     _   ! !
       !   Mark to show values for assigned allocation                       _   ! !
       !   -------------------------------------------------------------------   ! !
       !   Destination ....... STD_____       Form .....................     I   ! !
       !                                                                         ! !
       !   Duplicates ........ 0__            Disposition ..............     K   ! !
       !   Priority .......... 1__            Protected reports ........     N   ! !
       !   Retention period .. 9999  Days     for Dispositions      D  H  K  L   ! !
       !   using calendar ...  ________       (Y/N) ............... _  _  _  _   ! !
       !                                                                         ! !
       !   Type .............. NAF_____       linked to cluster .....   --       ! !
       !                                      Owner ................. N          ! !
       !   Notes                                                                 ! !
       !   ________________________________________________________________      ! !
       +-------------------------------------------------------------------------+ +
     Enter values for the logical printer.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

If you mark the field for selection of existing allocations, a list of all available allocations is displayed, and you can mark the desired allocation.

You can also display the values of the assigned allocation. To do so, mark the corresponding field.

The window above prompts you for the following parameters used to define the logical printer:

Parameter | Description
--- | ---
`Destination` | The name (maximum 8 characters) of the logical destination which, with Form, identifies all reports generated using this logical printer.
`Form` | A character which, with Destination, identifies all reports generated using this logical printer.
`Duplicates` | A numeric value giving the number of copies of the report which are to be printed.
`Disposition` |
An alphanumeric character which indicates the initial status of the report after it has been produced. Possible values are:
`D` | Keep the report on file in a printable status, that is, print it either when the physical printer is ready or upon an explicit request. After the report has been printed, it is deleted from the spool file.
`H` | Hold the report on file. To print the report, the user has to change the Disposition to a valid value different from `H`, see Function 10.
`K` | Keep the report on file in a printable status, that is, print it either when the physical printer is ready, or upon an explicit request. After the report has been printed, the Disposition is set to `L`.
`Priority` | A numeric value (`0-255`) giving the order in which the reports will be printed. A higher value means higher priority.
`Protected Reports` |
Reports created for a logical printer with type NAF can be protected. Possible values are:
R | Only the user who created the report can display it.
P | Only the user who created the report can purge it.
S | Only the user who created the report can start it.
G | Only the user who created the report can display or start it.
N | No protection.
`Retention period` | The number of days that the report is to be held on the spool file. The value 9999 indicates unlimited retention. The retention period can be limited to certain types of Disposition: in addition to the values `D`, `H` and `K` (see above), the value `L` (for printed reports with Disposition `K`) is also supported.
`using calendar` | When using the retention period, you can also specify the name of a calendar to take into account weekends and holidays.
`Type` |
`NAF` | The report is for NAF and is stored on the NAF spool file.
`NOM` | The report is for Entire Output Management and is stored on the NOM container file.
`Notes` | A short description of the logical printer.

The attributes `Duplicates`, `Priority` and `Disposition` can also be set dynamically by using the `DEFINE PRINTER` statement.

Note
The `Duplicates` attribute in the `DEFINE PRINTER` statement corresponds to the specification in the `COPIES` clause. In both cases, this refers to the number of copies to be printed.

## NAF - Allocation Table - Function 31.3

Allocations must be defined so that a relation is established between the reports and the physical printers to which the reports can be routed. An allocation is identified by the parameters which were defined for the logical printer (Destination and Form).

When a report is generated, `NATSPOOL` uses the associated allocation to start the printing activity on the first physical printer with status `FREE` (the Disposition value for that report must be either `K` or `D`). If the allocation is not found, or if none of the allocated physical printers is in `FREE` status, the report is kept on the spool file.

This section covers the following topics:

- Invoking Allocation Table

- Selecting an Allocation from a List

- Maintaining an Allocation

### Invoking Allocation Table

When you invoke this function, the Allocation Table window appears:

    Time 10:53:49        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                             M e n u                   File 7/411
                                           +------ Allocation Table 7/411 ------ ---+
            Administration                 !                                        !
                                           !  Enter name of                         !
            10 Reports / Queues            !                                        !
            11 Devices                     !      Destination / Form.               !
            12 Abstracts                   !                                        !
            13 Applications                !  or                                    !
            14 Change Spool File           !                                        !
                                           !      *    for Selection                !
            Maintenance                    !                                        !
                                           !      ?    for Help                     !
            30 Spool File Properties       !                                        !
            31 Objects                     !      .    for End                      !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !      -------------------------         !
            34 Transfer Objects            !      / ________ / _                    !
                                           !                                        !
                                           +----------------------------------------+
      Enter values.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

In this window, you can specify the name an existing Destination/Form, select a Destination/Form from a list of Destinations/Forms available or add a Destination/Form to the spool file.

### Selecting an Allocation from a List

To select an allocation from a list, enter one of the following:

- a partly-qualified name (e.g. `B*` to list all allocations starting alphabetically from B*),

- an asterisk (*) to list all allocations in the `NATSPOOL` system.

A list of allocations is then shown in a window.

    Time 11:16:46        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                             M e n u                   File 7/411
                                          +-------------Select with *--------------+
           Administration                 !  New start value ......... _________   !
                                          !  -----------------------------------   !
           10 Reports / Queues            !  Fl Cm  Name        Fl Cm  Name        !
           11 Devices                     !  -- --  ---------   -- --  ---------   !
           12 Abstracts                   !      _  BS2PID  H       _  CAYIMS  A   !
           13 Applications                !      _  DAEPRT10A       _  DAEPRT10H   !
           14 Change Spool File           !      _  DAEPRT12A       _  DAEPRT13A   !
                                          !      _  DAEPRT45A       _  DARMSTD A   !
           Maintenance                    !      _  DARMSTD 1       _  DARMSTD 2   !
                                          !      _  DARMSTD 3       _  DARMSTD 4   !
           30 Spool File Properties       !      _  DARMSTD 5       _  DARMSTD 8   !
           31 Objects                     !      _  DDR1171 A       _  DDR1490 A   !
           32 Mass Update                 !      _  DHCDEST H       _  DR1171  H   !
           33 Hardcopy Allocations        !      _  GRE10   H       _  HC      H   !
           34 Transfer Objects            !      _  HCDEST  H       _  HHI     A   !
                                          !      _  HHIDEST A       _  HHIPID  H   !
                                          +----------------------------------------+
     Mark on selection list.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                     --   +                       Canc

The allocations which were used for the initialization of the current Natural session are highlighted in the window.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`C` | Copy allocation.
`D` | Delete allocation.
`R` | Rename allocation.
`.` | Exit function.
`X` or any other character | Display allocation for modification or deletion, see below.

### Maintaining an Allocation

If the specified Destination/Form exists, the allocation is displayed. You can modify the list of allocated physical printers, specify a header page for the report or delete the whole allocation.

Note
If you specify a name that does not yet exist, you can add a new allocation. In this case, the Delete option is not provided in the window.

    Time 11:13:03        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
       +-------------------------- Allocation Table -----------------------------+
       !  Modify                 DARMSTD A              Delete (Y/N)         N   !
       !  --------------------------------------------------------------------   !
       !  Owner............... N                linked to Cluster ... TESTCLUS   !
       !  --------------------------------------------------------------------   !
       !  Header Page      ________                             Queue Status A   !
       !  Statistics (Y/N) Y                  Add/Modify Time values ....... N   !
       !  --------------------------------------------------------------------   !
       !  Physical Printer(s)                              Printer Selection _   !
       !                                                                         !
       !       Name    Ty.       Name    Ty.      Name    Ty.      Name    Ty.   !
       !  _  1 P007____ M   _  2 P002____ B  _  3 P003____ A  _  4 MK1_____ B    !
       !  _  5 MK2_____ A   _  6 MK3_____ B  _  7 MK4_____ A  _  8 MK5_____ B    !
       !  _  9 MK6_____ A   _ 10 MK7_____ B  _ 11 MK8_____ A  _ 12 MK9_____ B    !
       !  _ 13 MK10____ A   _ 14 MK11____ B  _ 15 MK12____ A  _ 16 MK13____ B    !
       !  --------------------------- Notes ----------------------------------   !
       !  ________________________________________________________________       !
       +-------------------------------------------------------------------------+
     Enter name of printer.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                                                  Canc

The window prompts for a list of up to 16 physical printers to which reports with the given destination and form can be routed. If you mark the field for printer selection, a list of all available physical printers is displayed, where the desired physical printer(s) may be marked by number. The number indicates the position in the list of physical printers in the screen above.

When you enter an asterisk (*) to the left of the printer name, the attributes for this printer are shown.

The first printer is the main printer (indicated by M in the type column). For this printer, the type cannot be modified.

When you define more than one physical printer, you have to define the type of printer. The following types can be defined for Printers 2 to 16:

Type | Usage
--- | ---
`A` | Alternate printer. Will be used if all other printers are already active or in `INOP` status.
`B` | Backup printer. Will only be used if all other printers are in `INOP` status.

In addition, you can specify the following:

- The name of a header page for the report to be printed or an asterisk (*) to select the header page from a list.

- The queue status. All reports for an allocation are called "queue". The queue status can be set to `A` (activated, all reports will be printed, if possible) or `D` (deactivated, all reports are collected on the spool file until the queue is activated).

- Whether you require statistics (`Y/N`). When you specify `Y`, the number of pages, lines and reports for this allocation are collected and can be maintained by using Function 20. When `Y` is specified, an additional field appears (Add/modify time values). When you specify `Y` for this additional field and press Enter, the Time Window appears in which you can restrict this function to a user-defined time range.

When an allocation (between a logical and a physical printer) is added to the spool file by a user, `NATSPOOL` checks whether the corresponding physical printer is present on the spool file. If the printer is not present, it is added automatically. In other words, it is not necessary to execute Function 31.4.

## NAF - Printer - Function 31.4

One or more physical printers must be defined to `NATSPOOL` to indicate where reports are to be routed.

Besides general information, a physical printer describes technical data required to establish a connection. This information depends on the operating system: CICS or IMS TM.

This section covers the following topics:

- Invoking Physical Printer

- Selecting a Physical Printer from a List

- Maintaining a Physical Printer

### Invoking Physical Printer

When you invoke this function, the Printer window appears:

    Time 15:02:17        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                              M e n u                  File 7/411
                                           +---------- Printer 7/411 ---------------+
            Administration                 !                                        !
                                           !  Enter name of                         !
            10 Reports / Queues            !                                        !
            11 Devices                     !       Printer                          !
            12 Abstracts                   !                                        !
            13 Applications                !  or                                    !
            14 Change Spool File           !                                        !
                                           !      *    for Selection                !
            Maintenance                    !                                        !
                                           !      ?    for Help                     !
            30 Spool File Properties       !                                        !
            31 Objects                     !      .    for End                      !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !      -------------------------         !
            34 Transfer Objects            !      / ________ /                      !
                                           !                                        !
                                           +----------------------------------------+
      Enter values.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

In this window, you can specify the name of an existing physical printer, select a physical printer from a list of printers available or add a new physical printer to the spool file.

### Selecting a Physical Printer from a List

To select a physical printer from a list, enter one of the following:

- a partly-qualified name (e.g. `D*` to list all physical printers starting alphabetically from D),

- an asterisk (*) to list all physical printers in the `NATSPOOL` system.

A list of physical printers is then shown in a window.

    Time 15:23:06        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                          +-------------Select with D*-------------+
           Administration                 !  New start value ......... _________   !
                                          !  -----------------------------------   !
           10 Reports / Queues            !  Fl Cm  Name        Fl Cm  Name        !
           11 Devices                     !  -- --  ---------   -- --  ---------   !
           12 Abstracts                   !      _  DAEPRTCA        _  DAEPRT10    !
           13 Applications                !   S  _  DAEPRT12        _  DAEPRT13    !
           14 Change Spool File           !      _  DAEPTR10        _  DAPERT13    !
                                          !      _  DEAPRTCA     S  _  DR1171      !
           Maintenance                    !   S  _  DR1490          _  HCTEST      !
                                          !      _  HHIPID          _  HUGO        !
           30 Spool File Properties       !      _  MK1             _  MK10        !
           31 Objects                     !      _  MK11            _  MK12        !
           32 Mass Update                 !      _  MK13            _  MK2         !
           33 Hardcopy Allocations        !      _  MK3             _  MK4         !
           34 Transfer Objects            !      _  MK5             _  MK6         !
                                          !      _  MK7             _  MK8         !
                                          +----------------------------------------+
     Mark on selection list.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                     --   +                       Canc

The physical printer which was used for the initialization of the current Natural session is highlighted in the window.

The `Fl` (flag) column indicates the following:

Flag | Description
--- | ---
`P` | Protected by administrator(s).
`S` | Physical printer is defined for usage by another operating/TP system.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`C` | Copy physical printer.
`D` | Delete physical printer.
`R` | Rename physical printer.
`.` | Exit function.
`X` or any other character | Display physical printer for modification or deletion, see below.

### Maintaining a Physical Printer

If the specified physical printer exists, it is displayed. You can modify the form feed parameters or delete the whole physical printer.

Note
If you specify a name that does not yet exist, you can add a new physical printer. In this case, the Delete option is not provided in the window.

    Time 10:29:04        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
       +-------------------------------- Printer --------------------------------+ +
       !  Modify                 DAEPRT10               Delete (Y/N)         N   ! !
       ! ---------------------------------------------------------------------   ! !
       ! Owner ........... N        Private printer N    Cluster ....   --       ! !
       ! ---------------------------------------------------------------------   ! !
       ! Standard profiles N                             Opsys/Tpsys  CICS____   ! !
       ! Statistics ...... N                                                     ! !
       !                                                                         ! +
       ! Check for form .. N    Initial form ________ / _  FF control B          ! !
       ! FF sequence ..... 0C00 LF sequence  1500          Sever exit ________   ! !
       !                                                                         ! !
       ! NTCC type  ...... ________                                              ! !
       ! ---------------------------------------------------------------------   ! !
       ! CICS System ID .. ____                                                  ! +
       ! ---------------------------------------------------------------------   ! !
       ! Notes                                                                   ! !
       !  ________________________________________________________________       ! !
       +-------------------------------------------------------------------------+ +
     Enter values for the printer.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

Note
The layout of the window above changes depending on the operating system specified.

The physical printer name must correspond to one of the following, according to the operating system used:

- the CICS Terminal ID, as specified in the CICS Terminal Control Table TCT; or

- it must be an IMS TM LTERM name.

You can specify the following for all operating systems:

- Whether standard profiles are to be used (`Y/N`). When you add a physical printer, a logical printer and Destination/Form are automatically created. The names of the logical printer and destination correspond to the name of the physical printer. As a form name, `A` is provided. If you specify `N`, these objects are deleted.

- The operating system or TP monitor for which you define the printer. You can specify CICS or IMS TM.

- Whether you require statistics (`Y/N`). If you specify `Y`, the number of pages, lines and reports for this allocation are collected and can be maintained by using Function 20. When `Y` is specified, an additional field appears (Add/modify time values). If you specify `Y` for this additional field and press Enter, the Time Window appears in which you can restrict this function to a user-defined time range.

- Whether the spool server is to check which form (Destination/Form) was printed on this physical device before (`Y/N`). If the form differs, printout is not started and a message is sent to the console.

- The initial form to be used if `Check for form` is set to `Y`. If you do not specify an initial form and this flag is set to `Y`, the first printout will be started and the Destination/Form of this report will then be used.

- When a form feed is to be performed. This information is only evaluated at print time (not when the report is stored on the spool file). Enter one of the following values:

  Value | Description
  --- | ---
  `A` | Form feed at beginning and end.
  `B` | Form feed at beginning only.
  `E` | Form feed at end only.
  `F` | Form feed at end only. (Leading form feed is ignored.)
  `I` | No form feed at beginning and end. (Leading form feed is ignored.)
  `N` | No form feed at beginning and end.
  `T` | Transparent (no modifications).

- Control sequences for the form feed and line feed.

- The type of printer if you work with printer-specific NTCC tables (see Function 31.8 and the `DEFINE PRINTER` statement).

- The name of the subprogram that takes control in the spool server over each block sent to the printer. If you do not specify a name, control is passed to the user exit USPSER01. If you do not want a user exit to take control, enter *DUMMY.

- A description of the physical printer can be added in the `Notes` field.

All other fields in the screen depend on the operating system currently:

- Maintaining a Physical Printer under CICS

- Maintaining a Physical Printer under IMS TM

#### Maintaining a Physical Printer under CICS

    Time 13:53:29        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
       +-------------------------------- Printer --------------------------------+ +
       !  Modify                 DAEPRT10               Delete (Y/N)         N   ! !
       ! ---------------------------------------------------------------------   ! !
       ! Owner ........... N        Private printer N    Cluster ....   --       ! !
       ! ---------------------------------------------------------------------   ! !
       ! Standard profiles N                             Opsys/Tpsys  CICS____   ! !
       ! Statistics ...... N                                                     ! !
       !                                                                         ! +
       ! Check for form .. N    Initial form ________ / _  FF control B          ! !
       ! FF sequence ..... 0C00 LF sequence  1500          Sever exit ________   ! !
       !                                                                         ! !
       ! NTCC type  ...... ________                                              ! !
       ! ---------------------------------------------------------------------   ! !
       ! CICS System ID .. ____                                                  ! +
       ! ---------------------------------------------------------------------   ! !
       ! Notes                                                                   ! !
       !  ________________________________________________________________       ! !
       +-------------------------------------------------------------------------+ +
     Enter values for the printer.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

A specific CICS system ID can be defined for each printer. If you do not specify a value, the value from the spool file options is used (see Function 30.5).

#### Maintaining a Physical Printer under IMS TM

    Time 14:05:10        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
       +-------------------------------- Printer --------------------------------+ +
       !  Modify                 IMSPRI                 Delete (Y/N)         N   ! !
       ! ---------------------------------------------------------------------   ! !
       ! Owner ........... N        Private printer N    Cluster ....   --       ! !
       ! ---------------------------------------------------------------------   ! !
       ! Standard profiles N                             Opsys/Tpsys  IMS TM__   ! !
       ! Statistics ...... N                                                     ! !
       !                                                                         ! +
       ! Check for form .. N    Initial form ________ / _ FF control  B          ! !
       ! FF sequence ..... 0C00 LF sequence  1500         Server exit ________   ! !
       ! ---------------------------------------------------------------------   ! !
       ! Printer Type .... ________  SCS printer (Y/N) Y  Buffer size 1024       ! !
       ! ---------------------------------------------------------------------   ! !
       ! IMS BMP Transaction ID .. ________                                      ! +
       ! IMS BMP JCL Member ...... ________                                      ! !
       ! Notes                                                                   ! !
       !  ________________________________________________________________       ! !
       +-------------------------------------------------------------------------+ +
     Enter values for the printer.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

Report data are processed differently. Therefore, you must specify SCS printers by entering `Y` (yes) or `N` (no) in the field SCS Printer. In addition, in the Buffer Size field, enter the size of the buffer used by the blocks transferred to the physical printer. The buffer size is defined in bytes and must be in the range of `256` and `4048`.

BMP name and JCL member can be defined for each printer. If you do not specify any values, the values from the spool file options are used (see Function 30.5).

## NAF - Header Page - Function 31.5

You can define a header page that is to be printed in front of each report.

This sectioncovers the following topics:

- Invoking Header Page

- Selecting a Header Page from a List

- Maintaining a Header Page

### Invoking Header Page

When you invoke this function, the Header Page window appears:

    Time 15:59:41        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +--------- Header Page 7/411 ------------+
            Administration                 !                                        !
                                           !  Enter name of                         !
            10 Reports / Queues            !                                        !
            11 Devices                     !       Header Page                      !
            12 Abstracts                   !                                        !
            13 Applications                !  or                                    !
            14 Change Spool File           !                                        !
                                           !      *    for Selection                !
            Maintenance                    !                                        !
                                           !      ?    for Help                     !
            30 Spool File Properties       !                                        !
            31 Objects                     !      .    for End                      !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !      -------------------------         !
            34 Transfer Objects            !      / ________ /                      !
                                           !                                        !
                                           +----------------------------------------+
      Enter values.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

In this window, you can specify the name of an existing header page, select a header page from a list of header pages available or add a new header page to the spool file.

### Selecting a Header Page from a List

To select a header page from a list, enter one of the following:

- a partly-qualified name (e.g. `S*` to list all header pages starting alphabetically from S),

- an asterisk (*) to list all header pages in the `NATSPOOL` system.

A list of header pages is then shown in a window.

    Time 16:13:44        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +-------------Select with *--------------+
            Administration                 !  New start value ......... _________   !
                                           !  -----------------------------------   !
            10 Reports / Queues            !  Fl Cm  Name        Fl Cm  Name        !
            11 Devices                     !  -- --  ---------   -- --  ---------   !
            12 Abstracts                   !      _  NAFSTDHP        _  STDHEAD     !
            13 Applications                !                                        !
            14 Change Spool File           !                                        !
                                           !                                        !
            Maintenance                    !                                        !
                                           !                                        !
            30 Spool File Properties       !                                        !
            31 Objects                     !                                        !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !                                        !
            34 Transfer Objects            !                                        !
                                           !                                        !
                                           +----------------------------------------+
      Mark on selection list.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                     --                           Canc

The header pages defined for the allocations that were used for the initialization of the current Natural session are highlighted in the window.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`C` | Copy header page.
`D` | Delete header page.
`R` | Rename header page.
`.` | Exit function.
`X` or any other character | Display header page for modification or deletion, see below.

### Maintaining a Header Page

If the specified header page exists, it is displayed. You can modify the header page or delete it.

Note
If you specify a name that does not yet exist, you can add a new header page. In this case, the Delete option is not provided in the window.

The standard header page `NAFSTDHP` can be used as a template for your own header pages. This header page is protected and can only be displayed/modified by using the password for the spool file.

Each header page may be up to 62 lines long and 130 columns wide. It may contain free text as well as keywords that are replaced during printing.

You can insert the following keywords in your header page:

Keyword | Description
--- | ---
`NAFCC` | Function (start, restart etc.).
`NAFJB` | Job number.
`NAFDT` | Current date.
`NAFTI` | Current time.
`NAFID` | User ID for the report.
`NAFDF` | Allocation for the report.
`NAFNA` | Report name from `DEFINE PRINTER` statement.
`NAFPR` | NTCC table name (profile).
`NAFFO` | Form name from `DEFINE PRINTER` statement.
`NAFLP` | Logical printer for the report.
`NAFCD` | Date of report creation.
`NAFCT` | Time of report creation.
`NAFPG` | Program name.
`NAFLI` | Library name.

The keywords above must be entered in upper-case letters. For an example, see the screen below.

    Time 12:19:35        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                      Header Page NAFSTDHP             File 7/411

       Name of header page    NAFSTDHP   Intern  FFFFFFFF   Delete (Y/N)           N
       Owner  N
       Allowed number of columns  130   / lines    62      current last line     49

      Col/  11        21        31        41        51        61        71        81
      Line   I---------I---------I---------I---------I---------I---------I---------I
       31     I                                                                I
       32     I                                                                I
       33     I Spool  Function    :  NAFFC                                    I
       34     I                                                                I
       35     I Current Date       :  NAFDT         Current Time    : NAFTI    I
       36     I                                                                I
       37     I Job Number         :  NAFJB         User ID         : NAFID    I
       38     I                                                                I
       39     I Destination / Form :  NAFDF         Logical Printer : NAFLP    I
       40     I                                                                I

      Modify values for header page.
      Command ==>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  Store  <<    --     -    +    Full   <     >    Canc

You can use the following standard Natural editor line commands with all possible combinations, such as `.CX-Y` (see the online help):

- `.X`

- `.Y`

- `.C`

- `.D`

- `.M`

- `.I`

To store the header page, press PF4.

## NAF - Application - Function 31.6

You can define applications that are to be accessed from within `SYSPOOL`. To access a defined application, use Function 13.

This section covers the following topics:

- Invoking Application

- Selecting an Application from a List

- Maintaining an Application

### Invoking Application

When you invoke this function, the Application window appears:

    Time 16:30:10        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +---------Application 7/411 -------------+
            Administration                 !                                        !
                                           !  Enter name of                         !
            10 Reports / Queues            !                                        !
            11 Devices                     !       Application                      !
            12 Abstracts                   !                                        !
            13 Applications                !  or                                    !
            14 Change Spool File           !                                        !
                                           !      *    for Selection                !
            Maintenance                    !                                        !
                                           !      ?    for Help                     !
            30 Spool File Properties       !                                        !
            31 Objects                     !      .    for End                      !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !      -------------------------         !
            34 Transfer Objects            !      / ________ /                      !
                                           !                                        !
                                           +----------------------------------------+
      Enter values.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

In this window, you can specify the name of an existing application, select an application from a list of applications available or add a new application to the spool file.

### Selecting an Application from a List

To select an application from a list, enter one of the following:

- a partly-qualified name (e.g. `S*` to list all applications starting alphabetically from S),

- an asterisk (*) to list all applications in the `NATSPOOL` system.

A list of applications is then shown in a window.

    Time 16:31:42        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +-------------Select with *--------------+
            Administration                 !  New start value ......... _________   !
                                           !  -----------------------------------   !
            10 Reports / Queues            !  Fl Cm  Name        Fl Cm  Name        !
            11 Devices                     !  -- --  ---------   -- --  ---------   !
            12 Abstracts                   !      _  ADABAS          _  BUFFER      !
            13 Applications                !      _  ERROR           _  HHI         !
            14 Change Spool File           !      _  MYAPPL          _  NOM         !
                                           !      _  SAGSIS          _  SYSMAIN     !
            Maintenance                    !      _  TP                             !
                                           !                                        !
            30 Spool File Properties       !                                        !
            31 Objects                     !                                        !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !                                        !
            34 Transfer Objects            !                                        !
                                           !                                        !
                                           +----------------------------------------+
      Mark on selection list.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                     --                           Canc

`P` in the `Fl` (flag) column indicates that the application has been protected by its owner.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`C` | Copy application.
`D` | Delete application.
`R` | Rename application.
`.` | Exit function.
`X` or any other character | Display application for modification or deletion, see below.

### Maintaining an Application

If the specified application exists, it is displayed. You can modify the parameters or delete the whole application.

Note
If you specify a name that does not yet exist, you can add a new application. In this case, the Delete option is not provided in the window.

    Time 16:31:42        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +----------- Application ----------------+
            Administration                 !  Modify                    ADABAS      !
                                           !  Delete (Y/N)                     N    !
            10 Reports / Queues            !  ----------------------------------    !
            11 Devices                     !  Owner .......................... N    !
            12 Abstracts                   !                                        !
            13 Applications                !                                        !
            14 Change Spool File           !  Private ........................ N    !
                                           !                                        !
            Maintenance                    !  ----------------------------------    !
                                           !  Library Name ............ SYSAOS__    !
            30 Spool File Properties       !                                        !
            31 Objects                     !  Start program ........... MENU____    !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !  Notes                                 !
            34 Transfer Objects            !  Adabas Online System____________      !
                                           !  ________________________________      !
                                           +----------------------------------------+
      Modify values or press PF-Key.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

For each application, a library and a start program has to be defined. You can also provide a short description.

With Function 30.7 the access rights for an application can be restricted to specific users.

## NAF - Cluster - Function 31.7

When using Natural Advanced Facilities in an environment which requires decentralized administration of printers, you can create groups of logical printers. These groups are called clusters. Administration of reports and printers (Functions 10 and 11) can be restricted to these clusters.

Each cluster is defined by a number of logical printers. When a logical printer is assigned to a cluster, all allocations and physical printers defined to the logical printer are automatically assigned to the cluster. Each logical printer, allocation and physical printer can only be assigned to one cluster.

Note
Since active clusters result in more Adabas calls, usage of clusters can be deactivated with Function 30.5. In this case, Function 31.7 cannot be invoked.

This section covers the following topics:

- Invoking Cluster

- Selecting a Cluster from a List

- Maintaining a Cluster

### Invoking Cluster

When you invoke this function, the Cluster window appears:

    Time 11:43:31        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +-----------Cluster 7/411 ---------------+
            Administration                 !                                        !
                                           !  Enter name of                         !
            10 Reports / Queues            !                                        !
            11 Devices                     !       Cluster                          !
            12 Abstracts                   !                                        !
            13 Applications                !  or                                    !
            14 Change Spool File           !                                        !
                                           !      *    for Selection                !
            Maintenance                    !                                        !
                                           !      ?    for Help                     !
            30 Spool File Properties       !                                        !
            31 Objects                     !      .    for End                      !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !      -------------------------         !
            24 Transfer Objects            !      / ________ /                      !
                                           !                                        !
                                           +----------------------------------------+
      Enter values.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  User  Logic Alloc Print Heade Appli Clust NTCC  Canc

In this window, you can specify the name of an existing cluster, select a cluster from a list of clusters available or add a new cluster to the spool file.

### Selecting a Cluster from a List

To select a cluster from a list, enter one of the following:

- a partly-qualified name (e.g. `C*` to list all clusters starting alphabetically from C),

- an asterisk (*) to list all clusters in the `NATSPOOL` system.

A list of clusters is then shown in a window.

    Time 12:16:16        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +-------------Select with *--------------+
            Administration                 !  New start value ......... _________   !
                                           !  -----------------------------------   !
            10 Reports / Queues            !  Fl Cm  Name        Fl Cm  Name        !
            11 Devices                     !  -- --  ---------   -- --  ---------   !
            12 Abstracts                   !      _  CLU01           _  TESTCLUS    !
            13 Applications                !                                        !
            14 Change Spool File           !                                        !
                                           !                                        !
            Maintenance                    !                                        !
                                           !                                        !
            30 Spool File Properties       !                                        !
            31 Objects                     !                                        !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !                                        !
            34 Transfer Objects            !                                        !
                                           !                                        !
                                           +----------------------------------------+
      Mark on selection list.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                     --                           Canc

`P` in the `Fl` (flag) column indicates that the cluster has been protected by an administrator.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`D` | Delete cluster.
`R` | Rename cluster.
`.` | Exit function.
`X` or any other character | Display cluster for modification or deletion, see below.

### Maintaining a Cluster

If the specified cluster exists, it is displayed. You can modify the individual parameters or delete the whole cluster.

Note
If you specify a name that does not yet exist, you can add a new cluster. In this case, the Delete option is not provided in the window.

    Time 10:52:30        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +-------------- Cluster -----------------+
            Administration                 !  Modify                  TESTCLUS      !
                                           !  Delete (Y/N)                   N      !
            10 Reports / Queues            !  --------------------------------      !
            11 Devices                     !  Owner(s) ..................... N      !
            12 Abstracts                   !  --------------------------------      !
            13 Applications                !  Display/remove assigned               !
            14 Change Spool File           !  Logical Printer(s) ........... N      !
                                           !                                        !
            Maintenance                    !  Add/remove from list of               !
                                           !  all Logical Printers ......... N      !
            30 Spool File Properties       !                                        !
            31 Objects                     !  Notes                                 !
            32 Mass Update                 !  ________________________________      !
            33 Hardcopy Allocations        !  ________________________________      !
            34 Transfer Objects            !                                        !
                                           !  Save Cluster ................. _      !
                                           +----------------------------------------+
      Modify values or press PF-Key.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  User  Logic Alloc Print Heade Appli Clust NTCC  Canc

In the window above, you can specify the following:

- Whether a list of the logical printers that have already been assigned to the cluster is to be displayed (`Y/N`). When you specify `Y`, you can mark a printer in the resulting window with `N` to remove it.

- Whether a list of all logical printers on the spool file is to be displayed (`Y/N`). When you specify `Y`, you can mark the printers that you want to assign to the current cluster with `Y` in the resulting window. To remove a printer from the current cluster, mark it with `N`. When a printer is marked with a plus sign (+), it has already been assigned to another cluster and can therefore not be assigned to the current cluster. A minus sign (-) means that the printer cannot be assigned since it is not a NAF printer.

- You can also provide a short description.

To save the cluster, mark the corresponding field in the window.

## NAF - NTCC Table - Function 31.8

An NTCC table contains printer-specific control information that is used during printing.

This section covers the following topics:

- Invoking NTCC Table

- Selecting an NTCC Table from a List

- Maintaining an NTCC Table

- Maintaining User-Defined Attributes for All Printer Types

- Maintaining a Conversion Table

- Maintaining a Printer Type

- Restrictions

### Invoking NTCC Table

When you invoke this function, the NTCC Table window appears:

    Time 15:06:07        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                          +----------- NTCC Table 7/411 -----------+
           Administration                 !                                        !
                                          !  Enter name of                         !
           10 Reports/Queues              !                                        !
           11 Devices                     !       NTCC Table                       !
           12 Abstracts                   !                                        !
           13 Applications                !  or                                    !
           14 Change Spool File           !                                        !
                                          !      *    for Selection                !
                                          !                                        !
           Maintenance                    !      ?    for Help                     !
                                          !                                        !
           30 Spool File Properties       !      .    for End                      !
           31 Objects                     !                                        !
           32 Mass Update                 !      -------------------------         !
           33 Hardcopy Allocations        !      / ________ /                      !
           34 Transfer Objects            !                                        !
                                          +----------------------------------------+
     Enter values.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  User  Logic Alloc Print Heade Appli Clust NTCC  Canc

In this window, you can specify the name of an existing NTCC table, select an NTCC table from a list of NTCC tables available or add a new NTCC table to the spool file.

### Selecting an NTCC Table from a List

To select an NTCC table from a list, enter one of the following:

- a partly-qualified name (e.g. `T*` to list all NTCC tables starting alphabetically from T),

- an asterisk (*) to list all NTCC tables in the `NATSPOOL` system.

A list of NTCC tables is then shown in a window.

    Time 15:06:45        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                          +-------------Select with *--------------+
           Administration                 !  New start value ......... _________   !
                                          !  -----------------------------------   !
           10 Reports/Queues              !  Fl Cm  Name        Fl Cm  Name        !
           11 Devices                     !  -- --  ---------   -- --  ---------   !
           12 Abstracts                   !      _  NAF             _  TEST1       !
           13 Applications                !                                        !
           14 Change Spool File           !                                        !
                                          !                                        !
                                          !                                        !
           Maintenance                    !                                        !
                                          !                                        !
           30 Spool File Properties       !                                        !
           31 Objects                     !                                        !
           32 Mass Update                 !                                        !
           33 Hardcopy Allocations        !                                        !
           34 Transfer Objects            !                                        !
                                          +----------------------------------------+
     Mark on selection list.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                     --                           Canc

`P` in the `Fl` (flag) column indicates that the NTCC table has been protected by its owner.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`C` | Copy NTCC table.
`D` | Delete NTCC table.
`R` | Rename NTCC table.
`.` | Exit function.
`X` or any other character | Display NTCC table for modification or deletion, see below.

### Maintaining an NTCC Table

If the specified NTCC table exists, it is displayed. You can modify the individual parameters or delete the whole NTCC table.

Note
If you specify a name that does not yet exist, you can add a new NTCC table. In this case, the Delete option is not provided in the window.

    Time 15:07:41        *** Natural Spool Administration ***      2022-04-06
    User SAG                            M e n u                    File 7/411
                                          +-------------- NTCC Table --------------+
           Administration                 !  Modify                TESTPROF        !
                                          !  Delete (Y/N)          N               !
           10 Reports/Queues              !  ------------------------------------- !
           11 Devices                     !  Owner (Y/N) .................. N      !
           12 Abstracts                   !  ------------------------------------- !
           13 Applications                !  Maintenance                           !
           14 Change Spool File           ! - user-defined attributes (Y/N) N      !
                                          ! - conversion table (Y/N)        N      !
                                          !                                        !
           Maintenance                    !  Notes                                 !
                                          !  ________________________________      !
           30 Spool File Properties       !  ________________________________      !
           31 Objects                     !  ------------------------------------- !
           32 Mass Update                 !  Enter  Printer Type                   !
           33 Hardcopy Allocations        !  * for selection or                    !
           34 Transfer Objects            !  . for exit function  ________         !
                                          +----------------------------------------+
     Modify values, or press a PF-key.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                                                  Canc

For each NTCC table, you can define different printer types. For each printer type, you can define standard attributes and/or user-defined attributes.

In the window above, you can specify the following:

- Whether you want to add or delete user-defined attributes that are valid for all printer types defined in the current NTCC table (`Y/N`).

- Whether you want to add or delete a conversion table for hexadecimal values that is valid for all printer types defined in the current NTCC table (`Y/N`).

- The name for a new printer type or of an existing printer type.

You can also enter an asterisk (*) to select an existing printer type from a list. In the `Cm` column of the resulting window, you can then enter one of the following codes:

Code | Description
--- | ---
`C` | Copy printer type.
`D` | Delete printer type.
`R` | Rename printer type.
`.` | Exit function.
`X` or any other character | Display printer type for modification or deletion.

### Maintaining User-Defined Attributes for All Printer Types

User-defined attributes are freely defined strings that can be up to 10 bytes long. While printing, these strings are replaced with printer-specific control sequences.

When you specify `Y` to add or delete user-defined attributes that are valid for all printer types defined in the current NTCC table, the following screen appears:

    Time 10:29:26        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
        +------------User defined attributes for  NTCC Table : TESTPROF-------------+
        !  _ #DEV#_____   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        !  _ __________   _ __________   _ __________   _ __________   _ __________ !
        +---------------------------------------------------------------------------+
      Mark with function or press PF key
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                                                  Canc

You can define up to 60 user-defined attributes.

In the example above,`#DEV#` was defined as a user-defined attribute.

You can mark an attribute with one of the following codes:

Code | Description
--- | ---
`D` | Delete user-defined attribute.
`.` | Exit function.
`X` or any other character | Add/modify a note for this attribute in a window.

### Maintaining a Conversion Table

With the option Conversion Table, you can convert hexadecimal values by using the internal NAF conversion table.

If you choose this option, a screen similar to the one below appears:

    Time 10:36:46        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                  Conversion Table for TESTPROF        File 7/411

            0   1   2   3   4   5   6   7   8   9   A   B   C   D   E   F
         0  40  01  02  03  04  05  06  07  08  09  0A  0B  0C0D 0E  0F
         1  10  11  12  13  14  15 16  17  18  19  1A  1B  1C  1D  1E  1F
         2  20  21  22  23  24  25  26  27  28  29  2A  2B  2C  2D  2E  2F
         3  30  31  32  33  34  35  36  37  38  39  3A  3B  3C  3D  3E  3F
         4  40  41  42  43  44  45  46  47  48  49  4A  4B  4C  4D  4E  4F
         5  50  51  52  53  54  55  56  57  58  59  5A  5B  5C  5D  5E  5F
         6  60  61  62  63  64  65  66  67  68  69  6A  6B  6C  6D  6E  6F
         7  70  71  72  73  74  75  76  77  78  79  7A  7B  7C  7D  7E  7F
         8  80  81  82  83  84  85  86  87  88  89  8A  8B  8C  8D  8E  8F
         9  90  91  92  93  94  95  96  97  98  99  9A  9B  9C  9D  9E  9F
         A  A0  A1  A2  A3  A4  A5  A6  A7  A8  A9  AA  AB  AC  AD  AE  AF
         B  B0  B1  B2  B3  B4  B5  B6  B7  B8  B9  BA  BB  BC  BD  BE  BF
         C  C0  C1  C2  C3  C4  C5  C6  C7  C8  C9  CA  CB  CC  CD  CE  CF
         D  D0  D1  D2  D3  D4  D5  D6  D7  D8  D9  DA  DB  DC  DD  DE  DF
         E  E0  E1  E2  E3  E4  E5  E6  E7  E8  E9  EA  EB  EC  ED  EE  EF
         F  F0  F1  F2  F3  F4  F5  F6  F7  F8  F9  FA  FB  FC  FD  FE  FF
     Modify values.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  Reset                                           Canc

In the example above, the hexadecimal value `00` has been replaced by the hexadecimal value `40` in all lines of the report. You can specify a conversion table for an entire NTCC table, but also for further table specifications in order to define a special printer type. The table defining the printer type is then processed before the entire NTCC table.

Note
The spool server interprets the hexadecimal values `0C`, `0D` and `15` as form feed, carriage return and line feed respectively. You cannot define any substitutes for these values. You can use these values for replacing other values. However, this can lead to undesirable side effects, such as unintended form feeds or line feeds.

### Maintaining a Printer Type

If the specified printer type exists, it is displayed. You can modify the individual parameters or delete the whole printer type.

Note
If you specify a name that does not yet exist, you can add a new printer type. In this case, the Delete option is not provided in the window.

    Time 15:11:52        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                          +-------------- NTCC Table --------------+
           Administration                 !  Modify                 TESTPROF       !
                                          !  Printer Type           PTYPE          !
           10 Reports/Queues              !  Delete (Y/N)                  N       !
           11 Devices                     !  ----------------------------------    !
           12 Abstracts                   !  Replacement for ESCAPE (H'27')   #    !
           13 Applications                !                                        !
           14 Change Spool File           !  Notes                                 !
                                          !  ________________________________      !
                                          !  ________________________________      !
           Maintenance                    !  ----------------------------------    !
                                          !  Maintenance functions                 !
           30 Spool File Properties       !  Standard attributes  ........... _    !
           31 Objects                     !  User-defined attributes  ....... _    !
           32 Mass Update                 !  Conversion table ............... _    !
           33 Hardcopy Allocations        !                                        !
           34 Transfer Objects            !  Save and exit function ......... _    !
                                          +----------------------------------------+
     Modify values, or press a PF-key.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                                                  Canc

You can specify the following:

- A replacement character for the escape character (`H'27'`) which normally indicates a control sequence. This is helpful, since escape characters often corrupt a screen.

- Whether you want to define, modify or delete standard attributes for the current printer type. See below.

- Whether you want to modify the user-defined attributes for the current printer type.

- Whether you want to modify the conversion table for hexadecimal values that is valid for the current printer type.

Below is information on:

- Maintaining Standard Attributes

- Maintaining Standard Attribute Definitions

- Maintaining User-Defined Attributes for Current Printer Type

#### Maintaining Standard Attributes

The standard attributes are the Natural attributes `AD`, `BX`, `CD`, `OPEN` and `CLOSE`.

The `OPEN` information is processed before the report is printed. It can consist of either text or control sequences (for example, to switch to landscape format). The `CLOSE` information is processed after the report has been printed and can also consist of text or control sequences.

When you choose to maintain the standard attributes that are valid for the current printer type, the following screen appears:

    Time 10:29:26        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +--------- Standard Attributes ----------+
            Administration                 !                                        !
                                           !                                        !
            10 Reports / Queues            !    _  AD=U  +         _  AD=C          !
            11 Devices                     !    _  AD=I            _  AD=V          !
            12 Abstracts                   !                                        !
            13 Applications                !    _  BX=L            _  BX=T          !
            14 Change Spool File           !    _  BX=R            _  BX=B          !
                                           !                                        !
            Maintenance                    !    _  CD=NE           _  CD=YE         !
                                           !    _  CD=TU           _  CD=GR         !
            30 Spool File Properties       !    _  CD=PI           _  CD=RE         !
            31 Objects                     !    _  CD=BL                            !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !    _  OPEN  +         _  CLOSE         !
            34 Transfer Objects            !                                        !
                                           !                                        !
                                           +----------------------------------------+
      Mark with function or press PF key
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                                                  Canc

This screen contains all available attributes. A plus (+) sign next to an attribute indicates that an attribute definition has already been provided.

You can mark an attribute with one of the following codes:

Code | Description
--- | ---
`D` | Delete attribute definition.
`X` or any other character | Display attribute definition for modification, see below.

#### Maintaining Standard Attribute Definitions

When you mark a standard attribute definition for modification or deletion, the following screen appears:

    Time 11:03:29        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                   Standard Attributes AD=U            File 7/411

       Attribute P2UL       NTCC Table TESTPROF Printer Type PTYPE1          Save _
       Replace character for ESCAPE #
       Hexadecimal Format          On Sequence :<U:       Alphanumeric Format
       -------------------------------------------------- -------------------------
       27110000000000000000000000000000000000000000000000 #?_______________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
       Hexadecimal Format         Off Sequence :U>:       Alphanumeric Format
       -------------------------------------------------- -------------------------
       27910000000000000000000000000000000000000000000000 #j_______________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
      Notes ...... ________________________________________________________________
      Mark with function or press PF key
      Command===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                                                  Ca

The internal attribute name for the standard attribute is shown. In the example above, the internal name for `AD=U` (underscoring) is `P2UL`. The corresponding internal On and Off sequences are `:<U:` and `:>U:`.

The following table lists the Natural attributes and the corresponding internal On and Off sequences.

Natural Attribute | On Sequence | Off Sequence
--- | --- | ---
`AD=U` | `:<U:` | `:U>:`
`AD=C` | `:<C:` | `:C>:`
`AD=I` | `:<I:` | `:I>:`
`AD=V` | `:<V:` | `:V>:`
`BX=L` | `:<BL:` | `:BL>:`
`BX=T` | `:<BT:` | `:BT>:`
`BX=R` | `:<BR:` | `:BR>:`
`BX=B` | `:<BB:` | `:BB>:`
`CD=NE` | `:<N:` | `:N>:`
`CD=YE` | `:<Y:` | `:Y>:`
`CD=TU` | `:<T:` | `:T>:`
`CD=GR` | `:<G:` | `:G>:`
`CD=PI` | `:<P:` | `:P>:`
`CD=RE` | `:<R:` | `:R>:`
`CD=BL` | `:<B:` | `:B>:`

The replacement character for the escape character (`H'27'`) that has been defined for the example above is a hash (#)

In the example above, the hexadecimal value `2711` is defined as the On sequence. This is the string which replaces the `AD=U` attribute when underscoring is switched on. As the Off sequence, the hexadecimal value `2791` is defined. This is the string which replaces the `AD=U` attribute when underscoring is switched off.

When you mark the `OPEN` or `CLOSE` attribute, the resulting screen is slightly different:

    Time 15:35:18        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                      Standard Attribute               File 7/411

       Attribute OPEN       NTCC Table TESTPROF  Printer Type PTYPE1      Save _
       Replace character for ESCAPE #

       Hexadecimal Format                                 Alphanumeric Format
       -------------------------------------------------- -------------------------
       C995A596898385000000000000000000000000000000000000 Invoice__________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________

       OPEN       to be used as control sequence _
       OPEN       to be used as text information *

      Notes ...... ________________________________________________________________

      Mark with function or press PF key
      Command===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                                                  Canc

For the `OPEN` and `CLOSE` attributes, you can specify the following:

- A hexadecimal or alphanumeric value for a control sequence, or text that is to be used before (`OPEN`) or after (`CLOSE`) a report is printed.

- Whether the `OPEN` or `CLOSE` attribute is to be used as control sequence or text information. You can only mark one of the two options.

To save the new definition, mark the Save field.

#### Maintaining User-Defined Attributes for Current Printer Type

When you choose to maintain the user-defined attributes that are valid for the current printer type, the following screen appears:

    Time 11:04:56        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                   +---User defined attributes for  NTCC Table TESTPROF / PTYPE1----+
            Admini !  _ #DEV#                                                       !
                   !                                                                !
            10 Rep !                                                                !
            11 Dev !                                                                !
            12 Abs !                                                                !
            13 App !                                                                !
            14 Cha !                                                                !
                   !                                                                !
            Mainte !                                                                !
                   !                                                                !
            30 Spo !                                                                !
            31 Obj !                                                                !
            32 Mas !                                                                !
            33 Har !                                                                !
            34 Tra !                                                                !
                   !                                                                !
                   +----------------------------------------------------------------+
      Modify values or press PF-Key.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                                                  Canc

In the example above, `#DEV#` was defined as a user-defined attribute. This attribute was defined for all printer types in the NTCC table.

You can mark an attribute with one of the following codes:

Code | Description
--- | ---
`D` | Delete attribute definition.
`X` or any other character | Display attribute definition for modification, see below.

When you mark an attribute and press Enter, the following screen appears and you can modify the attribute definition for the current printer type.

    Time 11:05:41        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                      User-defined Attribute           File 7/411

       Attribute #DEV#        NTCC Table TESTPROF  Printer Type PTYPE1        Save
      _

       Replace Character for ESCAPE  #

       Hexadecimal Format                                 Alphanumeric Format
       -------------------------------------------------- -------------------------
       D3C1E2C5D940F1000000000000000000000000000000000000 LASER 1__________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________
       00000000000000000000000000000000000000000000000000 _________________________

      Notes ...... Replacement for #DEV# for all printers with type PTYPE1

      Command===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                                                  Canc

In the example above, the alphanumeric value `LASER 1` was defined. While printing, the attribute `#DEV#` will be replaced with `LASER 1`.

#### Example:

This example explains how NTCC tables and reports work together.

The NTCC table `TESTPROF` contains the user-defined attribute `#DEV#` and printer types `PTYPE1` and `PTYPE2`. For these printer types, the following definitions apply:

- `PTYPE1`: the user-defined attribute `#DEV#` will be replaced with `LASER 1`. The standard attribute `AD=U` will be replaced with the On sequence `H'2711'` and the Off sequence `H'2791'`. For the standard attribute `OPEN`, the text information "Invoice" was defined.

- `PTYPE2`: the user-defined attribute `#DEV#` will be replaced with `INK 2`. The standard attribute `AD=U` will be replaced with the On sequence `H'2714'` and the Off sequence H'2794'.

There is a `DEFINE PRINTER` statement with the `PROFILE` parameter set to `TESTPROF`. Using the allocation `DEST/A`, this logical printer refers to the physical printers `PRINTER1` and `PRINTER2`. For these physical printers, the following applies:

- For `PRINTER1`, `PTYPE1` is defined as the printer type.

- For `PRINTER2`, `PTYPE2` is defined as the printer type.

The `WRITE` statement contains the following:

    'The' 'report' (AD=U) 'is printed on #DEV#'

This creates a report for the logical printer containing the following line:

    The :U<:report:>U: is printed on #DEV#

When the report is output on the physical printer `PRINTER1`, the spool server recognizes the connection between the NTCC table `TESTPROF` (of the `DEFINE PRINTER` statement) and the printer type `PTYPE1` (of the physical printer). The line above is then rendered as follows:

    The H'2711'reportH'2791' is printed on LASER 1

which results in the following output:

    Invoice
    The report is printed on LASER 1

When the same report is output on `PRINTER2`, the line above is rendered as follows:

    The H'2714'totalH'2794' is printed on INK 2

which results in the following output:

    The report is printed on INK 2

### Restrictions

If a report is created using an NTCC table defined in the `NTCCTAB` of the Natural parameter module, printer-specific replacement is not done by Natural Advanced Facilities. Replacement then occurs, as usual, when the report is created.

When the replacement is done by Natural Advanced Facilities and the required NTCC table with a printer type definition does not exist, the report cannot be printed and its status is set to MINT (missing NTCC table).

The assignment of the NTCC table of Natural Advanced Facilities can only be done dynamically by using the `DEFINE PRINTER` statement (`PROFILE` clause).

## NAF - Calendar - Function 31.9

Using a calendar, you can control the deletion of reports.

This section covers the following topics:

- Invoking Calendar

- Selecting a Calendar from a List

- Maintaining a Calendar

### Invoking Calendar

When you invoke this function, the Calendar window appears:

    Time 10:52:37        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 19999/1241
                                         +--------- Calendar 19999/1241 ----------+
          Administration                 !                                        !
                                         !  Enter name of                         !
          10 Reports/Queues              !                                        !
          11 Devices                     !       Calendar                         !
          12 Abstracts                   !                                        !
          13 Applications                !  or                                    !
          14 Change Spool File           !                                        !
                                         !      *    for Selection                !
                                         !                                        !
          Maintenance                    !      ?    for Help                     !
                                         !                                        !
          30 Spool File Properties       !      .    for End                      !
          31 Objects                     !                                        !
          32 Mass Update                 !      -------------------------         !
          33 Hardcopy Allocations        !      / ________ /                      !
          34 Transfer Objects            !                                        !
                                         +----------------------------------------+
    Enter values.
    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---

In this window, you can specify the name of an existing calendar, select a calendar from a list of calendars available or add a new profile to the spool file.

### Selecting a Calendar from a List

To select a calendar from a list, enter one of the following:

- a partly-qualified name (e.g. `T*` to list all calendars starting alphabetically from T),

- an asterisk (*) to list all calendars in the `NATSPOOL` system.

A list of calendars is then shown in a window.

    Time 11:07:20        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 19999/1241
                                         +-------------Select with *--------------+
          Administration                 !  New start value ......... _________   !
                                         !  -----------------------------------   !
          10 Reports/Queues              !  Fl Cm  Name        Fl Cm  Name        !
          11 Devices                     !  -- --  ---------   -- --  ---------   !
          12 Abstracts                   !      _  CAL2022         _  MKCAL       !
          13 Applications                !      _  MYCAL22         _  TESTCAL     !
          14 Change Spool File           !                                        !
                                         !                                        !
                                         !                                        !
          Maintenance                    !                                        !
                                         !                                        !
          30 Spool File Properties       !                                        !
          31 Objects                     !                                        !
          32 Mass Update                 !                                        !
          33 Hardcopy Allocations        !                                        !
          34 Transfer Objects            !                                        !
                                         +----------------------------------------+
    Mark on selection list.
    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit                     --

The calendars defined for the logical printer which was used for the initialization of the current Natural session are highlighted in the window.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`C` | Copy calendar.
`D` | Delete calendar.
`R` | Rename calendar.
`.` | Exit function.
`X` or any other character | Display calendar for modification or deletion, see below.

### Maintaining a Calendar

If the specified calendar exists, it is displayed. You can modify the individual parameters or delete the whole calendar.

Note
If you specify a name that does not yet exist, you can add a new calendar. In this case, the Delete option is not provided in the window.

    Time 11:10:08        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 19999/1241
          +-------------------------- Calendar MYCAL22 ---------------------------+
          !  Modify                MYCAL22                 Delete (Y/N)         N !
          !  -------------------------------------------------------------------- !
          !  Owner N                                                              !
          !  -------------------------------------------------------------------- !
          !  Default day for start of week (1-7) 1  / start of weekend (0,1-7)  0 !
          !  ( 1 - Monday          ,   7 Sunday          )                        !
          !  -------------------------------------------------------------------- !
          !  Notes                                                                !
          !  ________________________________________________________________     !
          !                                                                       !
          !  Mk Year Mk Year Mk Year Mk Year Mk Year Mk Year Mk Year Mk Year      !
          !  -- ---- -- ---- -- ---- -- ---- -- ---- -- ---- -- ---- -- ----      !
          !   _ 2022                                                              !
          !                                                                       !
          !                                                                       !
          !   Mark a year, or enter year  ____                                    !
          +-----------------------------------------------------------------------+
    Mark on the selection list, or enter a new year.
    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit                                                  Canc

In this window, you can enter the following:

- The default for the first day of the week.

- The default for the first day of the weekend. The value `0` means that weekends are not considered.

- A short description.

- A year (see below).

When you specify a year (for example, `2022`) and press Enter, the calendar for the first half of the specified year appears. Pressing Enter once more displays the second half.

    Time 10:59:14        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                   Calendar MYCAL22 / 2022             File 19999/1241
                     January                February             March
     Monday              3 10 17 24 31          7 14 21 28           7 14 21 28
     Tuesday             4 11 18 25          1  8 15 22           1  8 15 22 29
     Wednesday           5 12 19 26          2  9 16 23           2  9 16 23 30
     Thursday            6 13 20 27          3 10 17 24           3 10 17 24 31
     Friday              7 14 21 28          4 11 18 25           4 11 18 25
     Saturday         1  8 15 22 29          5 12 19 26           5 12 19 26
     Sunday           2  9 16 23 30          6 13 20 27           6 13 20 27
                     April                  May                  June
     Monday              4 11 18 25             2  9 16 23 30        6 13 20 27
     Tuesday             5 12 19 26             3 10 17 24 31        7 14 21 28
     Wednesday           6 13 20 27             4 11 18 25        1  8 15 22 29
     Thursday            7 14 21 28             5 12 19 26        2  9 16 23 30
     Friday           1  8 15 22 29             6 13 20 27        3 10 17 24
     Saturday         2  9 16 23 30             7 14 21 28        4 11 18 25
     Sunday           3 10 17 24             1  8 15 22 29        5 12 19 26
    ------------------------------------------------------------------------------
     Reset calendar _  Modify start/end of week _  Save values _   Exit function _
    Modify values, or press a PF-key.
    Command==>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit  Save  Modif Reset                               Canc

Non-working days, such as weekends are highlighted. Working days are not highlighted. To modify the status of a day (working or non-working day), mark the day with any character and press Enter.

Using the fields of the bottom of the screen, you can:

- reset the calendar to the default values,

- modify the first day of the week and of the weekend (for the current year only),

- save the values.

### On this page

- Deleting an Object
- NAF - User Profile - Function 31.1
- NAF - Logical Printer - Function 31.2
- NAF - Allocation Table - Function 31.3
- NAF - Printer - Function 31.4
- NAF - Header Page - Function 31.5
- NAF - Application - Function 31.6
- NAF - Cluster - Function 31.7
- NAF - NTCC Table - Function 31.8
- NAF - Calendar - Function 31.9