Function TT - TIBTAB Maintenance (Administrator)

#### Search Results

Search

# Function TT - TIBTAB Maintenance (Administrator)

This function allows you to maintain the Com-plete TIB definition table used during Com-plete startup to initialize the TIBTAB. During initialization, depending on sysparm TIBTAB, either the TIBTAB load module is loaded or an empty TIBTAB is created. Afterwards, in both cases, the TIBTAB is completed dynamically using this TIB definition table. For details about TIBTAB initialization, please refer to the section on TIBTAB in the Com-plete System Programming documentation.

In the TIB definition table, you can maintain TIBs supported via one of the access methods VTAM or ACCESS. Terminals connected to Com-plete using other access methods must be defined in the TIBTAB load module. The TIB definition table resides in Com-plete's system dataset. By default, the table is empty.

As a side benefit, this function can also be used to perform operations against the in-storage TIBTAB currently being used by Com-plete.

If you select the TT option from the Utilities menu, the TIBTAB Maintenance Functions Menu is displayed:

    12:37:59        TID    13          COM-5.1.          User MBE          19.04.97
                                -- TIBTAB Maintenance --                        UDT0

     Definitions for STARTUP  Fc Operand    Active TIBTAB            Fc Operand
     ------------------------ -- --------   ------------------------ -- -----------
     List TIB definitions.... LD (prefix)   List Terminals.......... LT (any)
     Show TIB definition..... SD name       Show single TIB......... ST name/number
     Add TIB definition...... AD name       Add TIB................. AT name
     Update TIB definition... UD name       Update TIB.............. UT name/number
     Delete TIB definition... DD name       Delete TIB.............. DT name/number
                                            Copy TIB to definition.. CT name/number

     Select function ........
     TIB name / number ......
     System .................               Options for COPY:
                                            Copy with TID .......... N (Y/N)
                                            Replace ................ N (Y/N)

     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                       End

You can select any of the TT subfunctions by entering the appropriate function code and an operand. Generally speaking, the TIB name must be entered to identify a TIB definition; a TIB in the active TIBTAB may be identified by either TIB name or TIB number (TID).

The System input field prompted is relevant only for sites sharing Com-plete system datasets among more than one system. Here, the appropriate Patch Character can be entered to maintain startup TIB definitions related to a local system. By default, if this field is left empty, the Global system is assumed. For functions dealing with the active TIBTAB, this field is ignored.

For subfunction CT (Copy) and for the Copy feature of subfunction LT, you can specify whether you want the TIDs to be copied or cleared and if existing TIB definitions shall be replaced or not. All other subfunctions ignore these options.

Note that operations against TIB definitions have no influence on the TIBTAB currently used by Com-plete, they become effective only when Com-plete is initialized next time. Additonally, operations (except Copy) performed on the active TIBTAB do not influence TIB definitions for startup.

## List

Use the subfunctions LD / LT to list contents of the TIB definition table or of the active TIBTAB respectively, for example (LD):

    12:41:57        TID    13          COM-5.1.          User MBE          19.04.97
     System: Global         -- TIB Definitions for Startup --                   UDT1

     FC Name       TID  Type   Device   UserID  Prty Lin Col Status  Alloc Note
     -------------------------------------------------------------------------------
     .  DAEEC306    14  VTAM   3270  L            1   24  80         start

     FC:  S how  U pdate  D elete               Reposition to:                   END
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                       End                           Forwd

You can specify a name or prefix you want the listing to be started from, either in the Operand field on the Functions menu or in the field prompted Reposition to on the List screen. The listing will be in alphabetical order by TIB name.

With the LT function, you can also specify a TIB number (TID) in these fields to request listing of the TIBTAB in ascending order by TID. By default, if you select the LD subfunction without an operand, TIB definitions are listed in alphabetical order by TIB name. If you select the LT subfunction without an operand, the active TIBTAB is listed in ascending order by TID.

Meaning of the output fields by column heading:

Heading | Meaning
--- | ---
FC | Input field for subfunction call.
Name | The name of the TIB.
TID | The Terminal Identification number. For subfunction LD, zero indicates that any free TID can be allocated to this TIB.
Type | The access method, e.g., VTAM or ACCESS.
Device | The device type of the terminal.
UserID | Filled out by subfunction LT only. The User ID, if any, currently logged on from the terminal connected to this TIB.
Prty | The dispatching priority (0-3), where 0 is the lowest priority.
Lin | The maximum number of lines to be used in a display or output.
Col | The length of the line (number of columns) to be used.
Status | Possible values for subfunction LT are: active The terminal is currently allocated to Com-plete. deleted The terminal as been deleted, e.g., using operator commands DELETE or IGNORE, or it has been de- fined to be brought up deleted. error A permanent I/O error has occurred at the terminal.
| For subfunction LD, this field is empty, except for TIB definitions with the parameter DELETED=YES specified.
Alloc | For subfunction LT: The way this TIB has been allocated. Possible values are:
fixed | TIB is defined in the TIBTAB load module.
start | TIB has been allocated during Com-plete startup due to an entry in the TIB definition table.
autom | TIB has been allocated automatically, e.g., during user logon processing.
admin | TIB has been allocated explicitely using the AT sub- function of this utility.
- | For subfunction LD: Always "start".
Note | After execution of a subfunction for the appropriate line: Result of the subfunction call.

The Show, Update, Delete, and Copy subfunctions are also available from the menu displayed by the appropriate List subfunction. When called from the List Menu, Delete and Copy subfunctions are executed immediately one after the other, without the TIB Parameter Menu being displayed each time for confirmation.

## The TIB Parameter Menu

All of the subfunctions Show, Add, Update, Delete, and Copy use the same TIB Parameter Menu to display and / or enable input or modification of TIB attributes, for example:

    16:13:22        TID    12          COM-5.1.          User MBE          19.04.97
    System: Global         -- TIB Definitions for Startup --                   UDT2

    TIB/LU name: DAEEC306         TIB number (TID):   14
    -------------------------------------------------------------------------------
    Access method / CUU: VTAM     (VTAM/ACCESS/cuu)
    Device type:........ 3270  L                              Hardcopy device:. No
    Access node number:.     0

    Alternate TID:......     0                                Share (VTAM):.... No
    Permanent HC TID:...     0                                Acquire (VTAM):.. No

    Lines X line length:    24 X  80                          Stall:........... No
    Alternate screen:...    24 X  80                          Deleted:......... No
    VTAM RUsize:........     0
                                                              Compress output:. Yes
                         1 2 3 4 5 6 7 8
    Receive msg classes: X X   X                              In "ALL" group:.. Yes
    User options:.......

    Printer type:.......             Forms:
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                      End

Most of the TIB parameters shown on this screen are equivalent to the parameters of the TIB macro used for generation of the TIBTAB load module. For detailed description of TIB parameters, please refer to the section on TIBTAB in the Com-plete System Programming documentation.

For printer devices, the following additional parameters kept in an extension of the TIB are available:

Heading | Meaning
--- | ---
Printer type | Eight-character printer type or class specification which can be analyzed, e.g., by logical output drivers. There are no restrictions on the contents of this field.
Forms | For printer devices supporting multiple printout forms: Specifies up to eight forms supported by a printer at one time. If one of these form names is specified for a printout in the Printout Spool Control Block (PSCB), and if a logical output driver exists, the printout is scheduled to the printer undependently on the form currently mounted for the printer. The logical output driver must analyze the form specified for the printout and take the appropriate actions.

If any of these parameters is specified for a printer, field TIBAPPRF contains the 31 bit address of a 40 byte block of following structure (residing above the 16MB line where applicable):

Location | Length | Format | Contents
--- | --- | --- | ---
Dec | Hex
0 | 0 | 8 | Character | Printer type
8 | 8 | 4 | Character | Form 1
12 | C | 4 | Character | Form 2
16 | 10 | 4 | Character | Form 3
20 | 14 | 4 | Character | Form 4
24 | 18 | 4 | Character | Form 5
28 | 1c | 4 | Character | Form 6
32 | 20 | 4 | Character | Form 7
36 | 24 | 4 | Character | Form 8

The default value for all fields is a character string of spaces. If none of the parameters is specified for a printer, field TIBAPPRF contains a value of hexadecimal zeroes.

## Show

Using the SD / ST subfunctions, you can display the parameter settings specified for a TIB definition or the values currently in effect for a TIB in the active TIBTAB.

## Add

Using the AD / AT subfunctions, you can add a new TIB definition or explicitly allocate another TIB from the active TIBTAB. The TIB name to be added must be specified in the Operand field of the Functions menu. The TIB Parameters Menu is displayed, with input fields for all parameters.

All parameter values are defaulted to the values of the TIB or TIB definition last used in a Show, Add, Update, Delete, or Copy subfunction during the current UUTIL TT session. If these values do not match your requirements, you can enter the access method and device type desired and press PF8 to set up the default values for this combination.

Note that the only access methods supported are VTAM and ACCESS.

You can specify a fixed TID to be used. If this TID is not free, allocation will fail with an appropriate warning message (immediately after you press PF5 for subfunction AT, during next Com-plete startup for subfunction AD). If you leave the TID zero, the TIB will be created with any free TID.

Specify the desired parameter values and press PF5 to store the new TIB definition or to allocate a TIB with the indicated attributes.

## Update a TIB Definition

When you call the UD subfunction, the TIB Parameters Menu appears, displaying the TIB definition. You can now modify any parameter values and update the TIB definition using the PF5 key.

## Update a TIB in the Active TIBTAB

Using the UT subfunction, you can modify some of the parameters of a TIB in the active TIBTAB.

Note
Unpredictable results may occur if you change a TIB in the active TIBTAB while it is in use, e.g., for terminal I/O. Therefore, the UT subfunction should be used very carefully.

When you call the UT subfunction, the TIB Parameters Menu appears, displaying the parameter values currently in effect for the TIB.

You can modify most of the parameters. TID, access method, and device type cannot be changed. When you press PF5, first the TIB is checked for any changes occurred since you entered the UT menu. If contents of any important field of the TIB have changed in the meantime, your modification will be denied. Otherwise, the TIB will be updated.

## Delete a TIB Definition

When you call the DD subfunction, the TIB Parameters Menu appears, displaying the TIB definition. You can now delete the TIB definition by pressing PF5. From the menu displayed by the LD subfunction, you can delete multiple TIB definitions at one time without being requested to confirm each of them.

## Free a "Deleted" TIB from the Active TIBTAB

Using the DT subfunction, you can free a TIBTAB entry which has the status "deleted" (see description of subfunction LT above in this section). If you want to free a TIB which has status "active" or "error", it must be "deleted" first using operator command IGNORE.

## Copy Contents of a TIB from the Active TIBTAB to a TIB Definition

Subfunction CT allows you to save contents of a TIB as a TIB definition for next Com-plete initialization. You can specify the TIB by name or by TID, and you can set additional options at the TIBTAB Maintenance Functions Menu as described above in this section. From the menu displayed by the LT subfunction, you can copy multiple TIBs at one time without being requested to confirm each of them.

### On this page

- List
- The TIB Parameter Menu
- Show
- Add
- Update a TIB Definition
- Update a TIB in the Active TIBTAB
- Delete a TIB Definition
- Free a "Deleted" TIB from the Active TIBTAB
- Copy Contents of a TIB from the Active TIBTAB to a TIB Definition