This service is used to define and maintain the parameters and definitions that are required by Adabas Vista.
To display the Maintenance menu
Select service 1 from the main menu.
Note:
The Current LFILE 152 Settings window may appear before the
Maintenance menu. See the section System
Settings for more information.
12:12:06 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-10-29
- Maintenance - V11000M1
Code Service
---- ----------------------------
1 File Partitioning
2 File Translation
3 Job Parameters
4 Target Categories
. Exit
---- ----------------------------
Code..: _
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Menu |
| From this menu, you can | Service | Cmd |
|---|---|---|
| maintain partitioned files and file partitions | 1 | 1.1 |
| maintain translation rules | 2 | 1.2 |
| maintain job parameter values | 3 | 1.3 |
| maintain target categories | 4 | 1.4 |
To list the files that have been defined as partitioned
Select service 1 from the Maintenance
menu or enter the command 1.1 on a command line.
15:58:21 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-11-21
- Maintain Partitioning Profiles - V11100M1
Reposition:
ProfID: ________ DBno.: _____ File: _____ Target Category: ________
<--------- Source ----------> I TEST (Target Category) >>>> I
C ProfID Name DBno. File I Part-Field API Version I
_ EMPL1 11 300 I LAST-NAME N Published/Draft I
_ VEHCL2 11 301 I DATE-OF-MANUFAC N Published I
_ EMPL3 11 302 I AE A 20 N Published I
_ VEHCL4 11 303 I DATE-OF-MANUFAC N Draft I
_ ACCTS EMP 11 302 I LAST-NAME N Published I
_ ACCTS MISCL5 11 305 I AA A 10 N Published I
_ MANUF EMPL3 11 302 I LAST-NAME N Published I
_ MANUF VEHCL4 11 303 I DATE-OF-MANUFAC N Published I
I I
Mark with
(D)ispl,(M)od,(P)urge,(C)opy,(W)ithdraw,(E)xpand,(L)ist,P(U)blish
End of List
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Refr Add >>>> Menu |
Each partitioned file is uniquely identified by a Profile ID, database number, and file number, together with a target category. In Natural systems, database and file numbers are defined in the DDM. The Profile ID and target category are set by the appropriate job parameter (defaults to blank Profile ID and default target category as specified on the Maintain Target Categories screen if no job parameter has been defined). The Profile ID and target category can be changed using an Adabas Vista API function.
Part-Field is the Adabas field used to distribute the data into the separate partitions.
A partitioned file definition may have a version status of published or draft. Only a published version can be executed; only a draft version can be modified.
Enter one of the following options in the C column to select an entry:
| d | display |
| m | modify |
| p | purge |
| c | copy |
| w | withdraw |
| e | expand |
| l | list target categories |
| u | publish draft definition |
PF11 (marked >>>>) may be used to scroll forward and back through all the target categories currently defined (see Maintain Target Categories for further details). A specific target category may be entered for re-positioning purposes.
To add a partitioned file
Press PF10 from the Maintain Partitioning Profiles screen to display the Add Partitioned File screen.
16:05:05 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-11-21
- Add Partitioned File - V11110M1
Version: Draft
Source Profile ... DBno.: 11 File: 1 Profile ID: ________ (optional)
Target Category: TEST Name: TESTFL1 (optional)
Partitioning Criteria .. Field Name ..... AA (from
Format ... A Adabas
Length ... 8 FDT)
Display as ..... ____________________
Options .. Enable API Override ... N (Y/N)
Command Limit ......... 0 (0=no limit)
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Add Opt+ Menu |
Refer to section Parameters for detailed information about each input field.
The version status of an added partitioned file is always draft.
If PF10 is pressed with the cursor in the C column, source information is taken from that definition. If the cursor is elsewhere on the screen when PF10 is pressed, there is no associated definition that can be used. In either case, new data may be specified in all fields on the screen.
Enter the source database, file number and the optional Profile ID. Also enter the target category. This must already have been defined using target category maintenance (see Maintain Target Categories for details).
An optional name may be defined for the partitioned file to make it easier to identify.
Enter the Adabas field information for the Partitioning Field.
Refer to the parameter Partitioning Field for more information.
In the example screen shown above, default values are used for all the options.
Press PF6 to modify the default settings.
+--------------------------------------------------------------------+ | 16:06:59 - Additional Options - V11110M2 | | | | Partition ID Assignment....... VISTA | | Maximum number of Partitions.. 255 | | ==> Default Partition TOPISN.. 16777215 | | | | Enable ISN Positioning........ YES | | User Partition Concurrency.... 8 (max. active CIDs/user) | | Store Control Option.......... 1 | | | | PF3 Return | +--------------------------------------------------------------------+ |
Refer to section Parameters for an explanation of each parameter.
Press PF5 to add the partitioned file definition.
If you need to make changes to the file definition just added, select it from the list by marking column C with an "m".
Define the physical partitions that will make up this file.
You have now defined the partitioned file, but you still need to define the physical partitions that will make up the file. You must define at least one physical partition to a partitioned file.
To define a partition
Select the partitioned file from the list by marking column C with an "e" to "expand" the file and press PF10 to "add" a new partition.
See the sections List Partitions and Add Partitions for more information.
To display a partitioned file definition
Select it from the list by marking column C with a "d".
16:09:27 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-11-21
- Display Partitioned File - V11120M1
Version: Published Last Modified: 2002-08-02 at 13:10:17 by UKCMH
Added: 2002-08-02 at 13:10:05 by UKCMH
Source Profile ... DBno.: 11 File: 301 Profile ID:
Target Category: TEST Name: VEHCL2
Partitioning Criteria .. Field Name ..... AG (from
Format ... U Adabas
Length ... 4 FDT)
Display as ..... DATE-OF-MANUFACTURE
Options .. Enable API Override ... N (Y/N)
Command Limit ......... 0 (0=no limit)
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Opt+ Exp Menu |
By default, the published version of the definition is displayed first. If there is no published definition, the draft version is displayed.
To switch between the versions when both a draft and a published
version exist
Press PF9.
To display the list of defined partitions
Press PF10.
To display the additional options
Press PF6.
To modify a partitioned file definition
Select it from the list by marking column C with an "m".
16:10:28 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-11-21
- Modify Partitioned File - V11130M1
Version: Draft Last Modified: 2002-08-02 at 13:10:17 by UKCMH
Added: 2002-08-02 at 13:10:05 by UKCMH
Source Profile ... DBno.: 11 File: 301 Profile ID:
Target Category: TEST Name: VEHCL2
Partitioning Criteria .. Field Name ..... AG (from
Format ... U Adabas
Length ... 4 FDT)
Display as ..... DATE-OF-MANUFACTURE
Options .. Enable API Override ... N (Y/N)
Command Limit ......... 0 (0=no limit)
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Upd Opt+ Publ Exp Menu |
Make any necessary modifications.
You may only modify the draft version of a partitioned file definition. If you attempt to modify a definition for which there is no draft version, a draft version is created automatically.
Press PF5 to confirm any modifications.
Press PF6 to modify the additional options.
To publish a draft version of a partitioned file definition,
either
Select it from the list by marking column C with a "m", then press PF9 to publish the file definition.
Or:
Select it from the list by marking column C with a "u".
In either case, the following screen is displayed:
+-------------------------------------------------------------------------+ | 16:11:49 Publish Profile V11160M2 | | | | Source Profile ... DBno.: 11 Fnr: 301 Profile ID: | | Name: VEHCL2 | | Mark | | X Publish profile to Target Category TEST | | _ Publish profile to all Target Categories | | | | Replace any existing Published Versions Y (Y/N) | | | | | | PF3 Exit PF5 Confirm | +-------------------------------------------------------------------------+ |
You must indicate whether the profile is to be published for a specific target category or if it is to be published for all target categories. You can also indicate whether or not existing published versions are to be overwritten.
To purge a partitioned file definition
Select it from the list by marking column C with a "p".
+---------------------------------------------------------------------------+ | 16:13:31 Purge Profile V11100M2 | | | | Source Profile ... DBno.: 11 Fnr: 300 Profile ID: | | Name: EMPL1 | | Mark | | X Purge Published Y Draft Y from Target Category TEST | | _ Purge Published N Draft N from all Target categories | | | | If, after the purge, no Published or Draft versions remain | | for any Target Category, the Source Profile will be purged. | | | | PF3 Exit PF5 Confirm | +---------------------------------------------------------------------------+ |
You must indicate whether the profile is to be purged for a specific target category or if it is to be purged for all target categories.
In addition, if both a published and draft version exist, you must identify (with "Y") the version(s) to be purged.
If only one version exists, the window acts as a confirmation screen.
Note:
The source profile will be purged if there are no definitions
remaining for any target category. The source profile will no longer appear on
the Maintain File Partitioning screen.
Press PF5 to confirm the purge request.
The withdraw option applies only to the published version of a partitioned file definition and results in the file no longer being available for use during program execution.
To withdraw a partitioned file definition
Select it from the list by marking column C with a "w".
+----------------------------------------------------------------------------+ | 16:15:12 Withdraw Profile V11160M1 | | | | Source Profile ... DBno.: 11 Fnr: 301 Profile ID: | | Name: VEHCL2 | | Mark | | X Withdraw profile from Target Category TEST | | _ Withdraw profile from all Target Categories | | | | Replace any existing Draft Versions Y (Y/N) | | | | | | PF3 Exit PF5 Confirm | +----------------------------------------------------------------------------+ |
You must indicate whether the profile is to be withdrawn for a specific target category or if it is to be withdrawn for all target categories.
In addition, you must identify (with "Y") whether or not the published profile which is being withdrawn is to replace any existing draft version.
Press PF5 to confirm the withdraw request.
Select the source profile from the list by marking column C with an "l".
16:33:27 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-12-09
- List Target Categories - V11180M1
Repo:________
Source Profile ... DBno.: 11 File: 301 Profile ID:
Name : VEHCL2
Target
C Category Description Part-Field API Version
_ PROD DATE-OF-MANUFAC N Published
_ QA DATE-OF-MANUFAC N Published
_ TEST DATE-OF-MANUFAC N Published
Mark with (D)ispl,(M)od,(P)urge,(C)opy,(W)ithdraw,(E)xpand,P(U)blish
End of List
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Refr Add Menu |
This screen displays all the target categories for the selected source profile.
The same options are available here as from the Maintain Partitioning Profiles screen.
To display the list of partitions defined to the partitioned
file
Select the partitioned file from the list on the Maintain Partitioning Profiles screen by marking column C with an "e":
16:19:20 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-11-21
- Maintain Partitions - V11190M1
<----Reposition ---->
Version: Draft PartitionDBno: _____
File: _____
Source Profile ... DBno.: 11 File: 302 Profile ID:
Target Category: TEST Name: EMPL3
Parts: 3
C Name DBNo. File Part ID ACSI Partitioning Field High Value
_ PART0001 110 16 1 FYND G9999999999999999999
_ PART0002 110 26 2 FYND O9999999999999999999
_ PART0003 11 260 3 FYND Z9999999999999999999
Mark with (D)isplay,(M)odify,(P)urge
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Refr Top Add Menu |
Enter one of the following options in the C column to select an entry:
| d | display |
| m | modify |
| p | purge |
Each partition is identified by a database and file number that is used by Adabas Vista to direct a command in order to satisfy a request for data.
The Partition ID (Part ID) uniquely identifies a partition and, together with the Adabas ISN, forms the Adabas Vista ISN.
The field ACSI contains the partition options: Access, Critical, Shared Partition, Adabas TOPISN. In the case of Adabas TOPISN, a value of D means that the default TOPISN for the partitioned file is in use for that partition. A value of U means that the default TOPISN has been overridden.
The field Partitioning Field High Value is the highest value of the partitioning field that can reside in each partition.
Refer to section Parameters for further information.
You may only add a partition to a draft version of a partitioned file definition.
To add a new partition
Press PF10 from the List Partitions screen to display the Add Partition screen.
16:21:21 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-11-21
- Add Partition - V11191M1
Version: Draft
Source Profile ... DBno.: 11 File: 302 Profile ID:
Target Category: TEST Name: EMPL3
PARTITION Name: ________ Database No.: _____ File No.: _____
Access .... FULL Adabas TOPISN ..... 16777215
Critical .. YES Shared Partition .. NO
Partitioning Field High Value ( A 20 )
===> <===
===> <===
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Upd Menu |
Enter the partition database and file number.
You may specify an optional name for the partition to more easily identify it.
Review the default options supplied and then specify the highest value of the partitioning field that will reside on this partition.
Refer to section Parameters for an explanation of the available options.
Press PF5 to add the partition and return control to the partition list.
To make changes to the partition just added, select the entry from the list by marking column C with an "m".
To display a partition
Select it from the list by marking column C with a "d".
16:22:24 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-11-21
- Display Partition - V11192M1
Version: Draft Last Modified: 2002-08-02 at 13:56:33 by UKCMH
Added: 2002-08-02 at 13:56:33 by UKCMH
Source Profile ... DBno.: 11 File: 302 Profile ID:
Target Category: TEST Name: EMPL3
PARTITION Name: PART0001 Database No.: 110 File No.: 16
Access .... FULL Adabas TOPISN ..... 16777215
Critical .. YES Shared Partition .. NO
Partitioning Field High Value ( A 20 )
===> G9999999999999999999 <===
===> <===
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Menu |
You may only modify a partition belonging to a draft version of a partitioned file definition.
To modify a partition
Select it from the list by marking column C with a "m":
16:23:31 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-11-21
- Modify Partition - V11193M1
Version: Draft Last Modified: 2002-08-02 at 13:56:33 by UKCMH
Added: 2002-08-02 at 13:56:33 by UKCMH
Source Profile ... DBno.: 11 File: 302 Profile ID:
Target Category: TEST Name: EMPL3
PARTITION Name: PART0001 Database No.: 110 File No.: 16
Access .... FULL Adabas TOPISN ..... 16777215
Critical .. YES Shared Partition .. NO
Partitioning Field High Value ( A 20 )
===> G9999999999999999999 <===
===> <===
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Upd Menu |
Press PF5 to confirm any modifications.
You may only purge a partition belonging to a draft version of a partitioned file definition.
To purge a partition
Select it from the list by marking column C with a "p".
+---------------------------------------------------------------+ | 16:24:52 Purge Partition V11190M2 | | | | Name: PART0001 DBno.: 110 File: 16 | | | | PF3 Exit PF5 Confirm | | | +---------------------------------------------------------------+ |
Press PF5 to confirm the purge request.
A translation rule is used by Adabas Vista to re-direct a command from a source environment to a target environment. It is uniquely identified by a Profile ID and a source database and file number.
The Profile ID, a 1-8 character alphanumeric value, is an optional attribute for a translation rule. Each translation rule applies to a particular target category.
The source database and file number identifies the file to the application. In Natural systems, this is the database and file number defined in the DDM.
The target database and file number indicate where a qualified command is to be directed.
A translation rule has two versions: a published version and a draft version. Only the published version can be executed; only the draft version can be modified.
To display a list of translation rules
Select service 2 from the Maintenance
menu or enter the command 1.2 on the command
line.
12:14:31 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-10-29
- Maintain Translation Profiles - V11200M1
Reposition:
ProfID: ________ DBno.: _____ File: _____ Target Category: ________
<--------- Source -----------> I <---------Target Category--------------->I
C ProfID Name DBno. File I DBno. File API Version I
_ EMPL1 1 1 I 1 10 N Published/Draft I
_ VEHCL 2 2 I 2 2 N Draft I
_ MISCELL 110 99 I ..............none I
_ ACCTS EMPL1 1 1 I 10 1 N Published I
_ ACCTS MISCELL 110 99 I 112 99 N Draft I
_ MANUF EMPL1 1 1 I 10 1 N Draft I
_ MANUF VEHCL 2 2 I 12 2 N Published I
Mark with (D)ispl,(M)od,(P)urge,(C)opy,(W)ithdraw,(L)ist,P(U)blish End of List
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Refr Add >>>> Menu |
Enter one of the following options in the C column to select a translation rule:
| d | display |
| m | modify |
| p | purge |
| c | copy |
| w | withdraw |
| l | list target categories |
| u | publish draft definition |
PF11 (marked >>>>) may be used to scroll forward and back through all the target categories defined to the system (see Maintain Target Categories for further details). A specific target category may be entered for repositioning purposes.
To add a new translation rule
Press PF10 from the Maintain Translation Profile screen to display the Add Translate Profile screen.
12:20:49 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-10-29
- Add Translate Profile - V11210M1
Version: Draft
Source Profile ... DBno.: 1 File: 0 Profile ID: (optional)
Target Category: TEST Name: MISC (optional)
Target ........... DBno.: 2 File: 0
Options .... Enable API Override ..... N (Y/N)
Command Limit ........... 0 (0=no limit)
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Add Menu |
The version of an added translation rule is always "draft".
Enter the Profile ID (optional), the source database and file number, the target category, and the target database and file number.
An optional name may be given to the translation rule to make it easier to identify.
A source and target file number of zero indicates that the translation rule applies to all files for the source database number (for this Profile ID and target category). If such a rule exists and a rule also exists for a specific file with the same source database number, then the file rule will override the "all-files" rule.
In the example screen, any access to database 1 is translated to database 2.
Press PF5 to add the translation rule definition.
To make changes to the rule just added, select the rule from the list by marking column C with an "m".
To display a file translation rule
Select it from the list by marking column C with a "d".
12:22:36 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-10-29
- Display Translation Profile - V11220M1
Version: Published Last modified 2002-09-23 at 11:06:19 by AVIAPI
Added 2002-09-20 at 13:30:24 by UKGXN
Source Profile ... DBno.: 1 File: 1 Profile ID:
Target Category: TEST Name: EMPL1
Target ........... DBno.: 1 File: 10
Options ...... Enable API Override ... N (Y/N)
Command Limit ......... 0 (0=no limit)
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Draft Menu |
By default, the published version of the rule is displayed first. If there is no published version, the draft version is displayed.
If both a draft and a published version exist, use PF9 to toggle between the versions.
To modify a translation rule
Select it from the list by marking column C with an "m".
12:25:06 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-10-29
- Modify Translation Profile - V11230M1
Version: Draft Last modified 2002-10-01 at 13:37:50 by UKGXN
Added 2002-10-01 at 11:49:29 by UKGXN
Source Profile ... DBno.: 1 File: 1 Profile ID:
Target Category: TEST Name: EMPL1
Target ......... DBno.: 100 File: 100
Options ...... Enable API Override ... N (Y/N)
Command Limit ......... 0 (0=no limit)
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Upd Publ Menu |
You may only modify the draft version of a translation rule. If you attempt to modify a rule for which there is no draft version, a draft version is created automatically.
Press PF5 to confirm any modifications.
To publish a draft version of a translation rule, either
Select it from the list by marking column C with "m", then press PF9,
Or:
Select it from the list by marking column C with a "u".
In the latter case, the following screen is displayed:
+-------------------------------------------------------------------------------+ | 17:24:46 Publish Profile V11250M2 | | | | Source Profile ... DBno.: 111 Fnr: 100 Profile ID: | | Name: TRAN1 | | Mark | | X Publish profile to Target Category TEST | | _ Publish profile to all Target Categories | | | | Replace any existing Published Versions Y (Y/N) | | | | PF3 Exit PF5 Confirm | +-------------------------------------------------------------------------------+ |
If the publish request is successful:
the draft version becomes the published version; and
the draft version is removed.
If a published version of the translation rule already exists, you are prompted to confirm your publish request.
If you confirm:
the draft version becomes the published version;
the previously existing published version is removed; and
the draft version is removed.
To purge a translation rule
1. Select it from the list by marking column C with "p".
+----------------------------------------------------------------------------+ | 12:26:58 Purge Profile V11200M2 | | | | Source Profile ... DBno.: 1 Fnr: 1 Profile ID: | | Name: EMPL1 | | | | Mark | | X Purge Published Y Draft Y from Target Category TEST | | _ Purge Published N Draft N from all Target Categories | | | | If, after the purge, no Published or Draft versions remain | | for any Target Category, the Source Profile will be purged. | | | | | | PF3 Exit PF5 Confirm | +----------------------------------------------------------------------------+ |
You must indicate whether the translation rule is to be purged for a specific target category or if it is to be purged for all target categories.
If the translation rule has both a published and a draft version, you must identify (with "Y") the version(s) to purge.
If there is only one version of the rule, the window acts only as a confirmation screen.
Press PF5 to confirm the purge request.
To copy a translation rule
Select it from the list by marking column C with "c".
12:28:49 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-10-29
- Copy Profile - V11240M1
FROM:
Source Profile ... DBno.: 1 Fnr: 1 Profile ID:
Name: EMPL1
TO: (Draft)
Source Profile ... DBno.: 1 Fnr: 2 Profile ID: ________ (optional)
Name: EMPL2 (optional)
Mark
X Copy Published Y Draft Y from Target Category TEST to ________
_ Copy Published N Draft N for all Target Categories
The Copy function only creates Draft versions.
Therefore,when appropriate,you must choose to copy from the
Published or Draft versions.
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Copy Menu |
You must indicate whether the translation rule is to be copied for a specific target category or if it is to be copied for all target categories.
If the translation rule has both a published and a draft version, you must identify (with "Y") the version(s) to be copied.
The resulting version of any copied rule is always draft.
Any validation processing performed as a result of the copy is identical to that of an Add Translation rule request.
The withdraw option applies only to the published version of a translation rule. When withdrawn, the rule is no longer available for use during program execution.
To withdraw a translation rule
Select it from the list by marking column C with "w".
+----------------------------------------------------------------------------+ | 12:31:06 Withdraw Profile V11250M1 | | | | | | Source Profile ... DBno.: 1 Fnr: 1 Profile ID: | | Name: EMPL1 | | | | Mark | | X Withdraw profile from Target Category TEST | | _ Withdraw profile from all Target Categories | | | | Replace any existing Draft Versions Y (Y/N) | | | | | | PF3 Exit PF5 Confirm | +----------------------------------------------------------------------------+ |
You must indicate whether the profile is to be withdrawn for a specific target category or if it is to be withdrawn for all target categories.
In addition, you must identify (with "Y") whether or not the published profile which is being withdrawn is to replace any existing draft version.
Press PF5 to confirm the withdraw request.
If no draft version of the translation rule exists:
the withdrawn published version becomes the draft version; and
the published version is removed.
If a draft version of the translation rule exists:
it is replaced or retained depending on whether you specified "Y" or "N"; and
the published version is removed.
An Adabas Vista job is uniquely identified by a job type and job name. Job parameters are used to allocate specific parameter values to specific jobs.
Note:
See section Parameters for a complete description
of all job parameters.
To display a list of existing jobs
Select service 3 from the Maintenance
menu or enter the command 1.3 on the command
line.
12:36:59 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-10-29
- Maintain Job Parameters List - V11300M1
<-- Reposition -->
Job Type:________
Name :________
Daemon Vista Profile Trace
C Job Type Job Name Group On/Off Overrides Active
_ Batch CMHD**** ON NO YES
_ *DEFAULT ON YES NO
_ CMHBATCH ON YES NO
_ COM-PLETE *DEFAULT ON NO NO
_ GXN OFF YES YES
Mark with (D)isplay,(M)odify,(P)urge,(R)ename,(C)opy,(O)verrides
Top of List
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Refr Add All Menu |
This screen lists all job parameters that have been defined for Adabas Vista.
To position within the list, enter the job type and name in the fields under the <-- Reposition --> indicator in the top right area of the screen.
To list all job parameters for all products that share the same
configuration file
Press PF11.
PF11 lists all job parameters that have been defined for Adabas Vista and for all other products (for example, Adabas Fastpath) that share the same configuration file.
To position within the list, enter the job type and name in the fields under the <-- Reposition --> indicator in the top right area of the screen.
To add a new job definition
Press PF10 from the Maintain Job Parameters screen.
+------------------------------------+ ! 09:24:13 Add 2003-05-16 ! ! Job Parameters V11310M1 ! ! ! ! Job Name: ________ ! ! (D= Default for Job Type) ! ! ! ! _ Batch ! ! _ COM-PLETE ! ! _ CICS Cluster ! ! _ CICS ! ! _ IMS/DC ! ! _ UTM ! ! _ TSO ! ! _ CMS ! ! _ TIAM ! ! _ None above ! ! Mark to Select a Job Type ! ! ! ! Command ==> ! ! PF1 Help PF3 Exit ! ! ! +------------------------------------+ |
Mark the type of job required in the resulting Add Job Parameters window.
Each different job type has a different characteristic: it is important to select the correct type.
If you mark the selection "None of the above", another selection window appears with additional job types.
If you need to use any of these, contact Software AG for advice.
After selecting a job type, press ENTER.
+--------------------------------------+ ! 09:24:33 Add 2003-05-16 ! ! Job Parameters V11310M3 ! ! ! ! Job Type: Batch ! ! ! ! Job Name: X_______ ! ! (D = Default for Job Type) ! ! Vista ON/OFF for Job: ON_ ! ! ! ! ----------- Daemon Mode ------------ ! ! (Usually for Clustered Applications) ! ! Service Name: ________ ! ! Coordinator Group Name: ________ ! ! ------------------------------------ ! ! ! ! *********************** ! ! * PF5 to Confirm Add * ! ! *********************** ! ! ! ! Command ==> ! ! PF1 Help PF3 Exit ! ! ! +--------------------------------------+ |
Enter a job name in the resulting window.
It is possible to enter one or more asterisks (*) to indicate a wild
card. For example, the job parameter with the name
CICS**PR is found by any job with the name CICS in
positions 1-4 and PR in positions 7-8, no matter what the characters are in
positions 5-6. If an asterisk (*) is the last character in a job name, the
remainder of positions in the name through the eighth are padded with
asterisks.
The initial parameter values set up for the new job are copied from those specified in the *DEFAULT entry for the selected job type.
If no default entry exists for the job type, then Adabas Vista product default values are used.
Job parameters are always matched on type. The order of search within type is
Match on exact job name.
Match on wild card definitions.
Use the default for the job type, if one has been defined.
Note that the number of wild card job names defined for a job type has a direct effect on the number of Adabas commands needed to establish the job parameters at initialization. This is particularly relevant to batch jobs that process relatively few Adabas commands.
For an explanation of the Coordinator Group Name and Clustered Application Service Name, refer to the section Parameters and to the Adabas System Coordinator documentation.
To create a default job definition, select the appropriate job type and enter a "D" as the name.
Note:
Default job definitions are not available for job type CICS
Cluster.
A specific job definition overrides any default definition.
When a job parameter is added, control is returned to the job list.
To make changes to the parameter record just added, select the job from the list by marking column C with an "m".
To maintain a job parameter
Select it by entering one of the following options in column C on the Maintain Job Parameters screen:
| d | display |
| m | modify |
| p | purge |
| r | rename |
| c | copy |
| o | job parameter overrides |
Display and modify produce similar results. For purge, rename, and copy, you are prompted to confirm the action to be taken.
Job parameter overrides may be specified for the job by marking column C with "o".
12:42:31 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-10-29
- Display Job Parameters - V11320M1
Job Type: Batch
Name: CMHBATCH Last modified 2002-10-29 at 12:41:37 by UKCMH
Added 2002-10-29 at 12:41:37 by UKCMH
Default Profile ID ...
Target Category ... TEST Vista ON/OFF for Job ...... ON
Enable Profile Overrides .. YES
Database number for ET-Data ............... 0
Enable Multiple Database Updates .......... YES
Global Format IDs Natural... YES 3GL... NO
Distributed Lock Mode ..................... 0
Error Response Code (ADARSPnnn) ........... 249
Profile Overrides/Selection by Profile ID.. NO
Trace Activation ..... NO Cmds.. 128
Error Reporting ..WTO YES
Profile ID Validation ............ NO
Read-Ahead Process (Vista/Adabas). V
Read-Ahead Pool Size (k).......... 256
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit More Menu |
In the example, default parameters values are shown since the definition for batch job CMHBATCH has just been created.
See section Parameters for information on each parameter.
Press PF10 to maintain additional job-related parameters:
+--------------------------------------------------------+ | 12:44:18 System Coordinator Parameters 2002-10-29 | | U1SCJPM1 | | | | Estimated Client Sessions: 1000 | | Fixed Memory Pool Size(k): 256 | | | | System Coordinator Group Name: | | Clustered Application Service Name: ________ | | | | Manage Terminal Sessions only: X | | or Manage All Sessions: _ | | | | | | | | PF1 Help PF3 Exit | +--------------------------------------------------------+ |
These additional parameters are used by the Adabas ystem Coordinator to provide environmental support to Adabas Vista.
The Estimated Client Sessions and Fixed Memory Pool Size parameters are used to enhance the memory allocation and management for the job. The memory pools controlled by these parameters are dynamically expandable; however, performance may be improved by minimizing the number and frequency of pool expansions.
These parameters are explained in more detail in section Using Adabas Vista with Cluster Services and the Adabas System Coordinator documentation.
Job parameter overrides can be specified by marking column C with "o" for a job.
17:45:00 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2002-11-21
- Maintain Job Profile Overrides - V11370M1
<-- Reposition -->
ProfID: ________
DBno: _____
File: _____
Job Type: Batch Profile ID: (default)
Name: CMHJOBD Target Category: TEST (default)
<--------- Source ---------> Target Category
C ProfID Name DBno. File Override <-- Version -->
_ OVRD0001 11 302 PROD Published
_ ACCTS OVRDP002 11 302 QA Published
Mark with (D)isplay,(M)odify,(P)urge,(C)opy,(W)ithdraw,P(U)blish
End of List
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Refr Add Menu |
Job profile overrides may be specified for any job. A specific override is only activated when its version is published. The job must have profile overrides enabled for these overrides to take effect (see parameter Enable Profile Overrides).
Select the job for which overrides are to be maintained by entering one of the following options in column C on the Maintain Job Profile Overrides screen:
| d | display |
| m | modify |
| p | purge |
| c | copy |
| w | withdraw |
| u | publish |
To add a new job profile override, press PF10.
15:40:03 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2003-01-28
- Add Job Profile Override - V11371M1
Version: Draft
Source Profile... DBno. 11 Fnr 303 Profile ID
Name OVRD0003
Target Category Override... TEST
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Add Menu |
Specify the source profile database, file number and optional Profile ID. An optional name may be entered for easier identification of a specific override.
Specify a target category override. This must already exist; see Maintain Target Categories for details.
To list the target categories that have been defined
Select service 4 from the Maintenance
menu or enter the command 1.4 on a command line.
15:46:42 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2003-01-28
- Maintain Target Categories - V11400M1
Target
C Category Description
_ PROD
_ QA
_ TEST
Mark with (D)isplay,(M)odify,(P)urge,(C)opy,(W)ithdraw,P(U)blish
End of List
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Refr Add Menu |
The default target category is identified thus: (D).
Enter one of the following options in the C column to select an entry:
| d | display |
| m | modify |
| p | purge |
| c | copy |
| w | withdraw |
| u | publish |
To add a new target category
Press PF10 from the Maintain Target Categories screen to display the Add Target Category screen.
15:53:28 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2003-01-28
- Add Target Category - V11410M1
Target Category: ________ Default: N
OPTIONS Enable API Override......: N
Command Limit............: 0
Description: _____________________________________________
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Upd Menu |
Enter the target category. You may also add an optional description for this target category.
Change the default specification to "Y" if this new target category is to be the default. You are prompted to confirm that you wish to override the existing default.
Specify the appropriate additional options. Press PF5 to add the target category.
If you need to make changes to the target category just added, select it from the list by marking column C with an "m".
To display a target category
Select it from the list by marking column C with a "d".
16:00:23 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2003-01-28
- Display Target Category - V11420M1
Last Modified: 2003-01-28 at 15:59:01 by UKCMH
Added: 2003-01-28 at 15:59:01 by UKCMH
Target Category: PROD Default: N
Description:
OPTIONS Enable API Override ...........: N (Y/N)
Command limit .................: 0 (0=no limit)
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Menu |
To modify a target category
1. Select it from the list by marking column C with an "m".
16:01:50 ***** A D A B A S VISTA SERVICES 7.4.2 ***** 2003-01-28
- Modify Target Category - V11430M1
Last Modified: 2003-01-28 at 15:59:01 by UKCMH
Added: 2003-01-28 at 15:59:01 by UKCMH
Target Category: PROD Default: N
Description: _________________________________
OPTIONS Enable API Override ...........: N (Y/N)
Command limit .................: 0 (0=no limit)
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Upd Menu |
Make any necessary modifications. See the parameters
Enable API Override
and Command
Limit for more information.
Press PF5 to confirm any modifications.
This option can be used to purge selected source profiles for this target category. The target category itself may, optionally, be purged if there are no source profiles remaining.
To purge a target category
Select it from the list by marking column C with a "p".
+--------------------------------------------------------------------------+ | 16:18:42 Purge Target Category V11440M1 | | | | Target Category: PROD | | | | Purge all Source Profiles...Purge Published Y Draft Y | | | | If, after the purge, no Published or Draft versions remain | | for any Source Profile, the Target Category will be purged: N (Y/N | | | | PF3 Exit PF5 Confirm | +--------------------------------------------------------------------------+ |
Identify the type of source profiles to be purged.
Indicate whether the target category is to be purged if no versions remain for any source profile.
Press PF5 to confirm the purge request.
This option can be used to copy source profiles for this target category.
To copy a target category
Select it from the list by marking column C with a "c".
+--------------------------------------------------------------------------+ | 16:23:45 Copy Target Category V11450M1 | | | | | |FROM: Target Category: PROD | | | | | |TO : Target Category: ________ | | | | Copy Source Profiles? N (Y/N) | | | | | | PF1 Help PF3 Exit PF5 Confirm PF12 Menu | +--------------------------------------------------------------------------+ |
Identify the new target category.
Indicate whether the source profiles are to be copied as well.
Press PF5 to confirm the copy request.
This option can be used to withdraw all source profiles for the selected target category, changing them from published status to draft status.
To withdraw a target category
Select it from the list by marking column C with a "w".
+--------------------------------------------------------------------------+ | 16:27:03 Withdraw Target Category V11460M1 | | | | Target Category: PROD | | | | Withdraw all Source Profiles...Replace Draft Y | | | | | | PF3 Exit PF5 Confirm | +--------------------------------------------------------------------------+ |
Indicate whether any existing draft versions of the source profiles are to be replaced.
Press PF5 to confirm the withdraw request.
This option can be used to publish all source profiles for the selected target category, changing them from draft status to published status.
To publish a target category
1. Select it from the list by marking column C with a "u".
+--------------------------------------------------------------------------+ | 16:30:10 Publish Target Category V11460M2 | | | | Target Category: PROD | | | | Publish all Source Profiles...Replace Published Y | | | | | | PF3 Exit PF5 Confirm | +--------------------------------------------------------------------------+ |
Indicate whether any existing published versions of the source profiles are to be replaced.
Press PF5 to confirm the publish request.
