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.
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: | |||||||||
|
||||||||||
| 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.
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.
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.
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 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 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 to store the new TIB definition or to allocate a TIB with the indicated attributes.
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.
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 , 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.
When you call the DD subfunction, the TIB Parameters Menu appears, displaying the TIB definition. You can now delete the TIB definition by pressing . 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.
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.
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.