Appendix C
The UNLOAD Program
The UNLOAD.JPAK.NSD program allows system administrators to make global changes to the configuration files contained within the CONFIGIX program. It performs the following tasks:
• Output an editable ASCII version of the configuration files.
• Backup the following five configuration files found in the JPAK group:
CONFIG
FOLDERA
FOLDERF
FOLDERR
FDISPLY
• Use the edited ASCII file as input to populate the five configuration files with data.
Any text editor that works with the e3000 can view or edit the ASCII file.
You must be very familiar with entries and syntax contained in CONFIGIX to edit this
ASCII file. Refer to Chapter 3, The CONFIGIX program for information about
CONFIGIX entries and syntax.
Create an ASCII configuration file
1
Logon to the system as MGR.NSD,PUB.
2
Enter the :FILE command specifying the name for the ASCII configuration file.
:FILE TEXTCNFG;SAVE;DISC=50000
Nobix ElectroPage Administrator’s Reference Guide 97
Appendix C The UNLOAD Program
3
Run the UNLOAD program using the ASCII configuration file name.
:UNLOAD.JPAK > *TEXTCNFG
UNLOAD creates an ASCII file named TEXTCNFG in the JPAK group.
Example—.
6
7
4
5
8
1
2
3
0:GLOBAL:$GLOBAL:::::HEADER:NUM:0
0:GLOBAL:$GLOBAL:::::CHECKIF:NUM:1
0:GLOBAL:$GLOBAL:::::CHECKIF:NUM:0
0:GLOBAL:$GLOBAL:::::CHECKEOJ:NUM:1
0:GLOBAL:$GLOBAL:::::CHECKEOJ:NUM:0
0:GLOBAL:$GLOBAL:::::CONTOK:NUM:0
0:GLOBAL:$GLOBAL:::::STARTXEQ:TEXT:” “
0:GLOBAL:$GLOBAL:::::ERROR:TEXT:”(CIERR”
Edit the ASCII configuration file
1
Use any text editor to view or edit the ASCII configuration file.
:EDITOR
/T TEXTCNFG
2
When the edits are complete, keep the file.
/K TEXTCNFG,UNN
/EXIT
The text editor saves the changes to the ASCII configuration file.
3
7
1
2
Rules for editing the ASCII file
• The ASCII file is structured into records and fields.
• Fields are delineated by colons (:).
• The first field, named Category, groups lines together that have the same category number. Category numbers range from 1 to 10.
• Category number definitions and descriptions are as follows:
Cat. # Contains
0 Global definitions
8
Job Specific definitions
IBM report definitions
Report Specific definitions
FOLDERF definitions
(Top-level and Sub-folder)
FOLDERR definitions
(Report folders)
Non-editable fields
Fields 2 through 9
Fields 2, 3, 8, or 9
Fields 2, 8, and 9
Fields 2, 8, and 9
Field 2, or a field with the value
$FOLDERHEADER
(Toplevel)
Field 2
Editable fields
Field 10, which follows
TEXT: or NUM:
Fields 4, 5, 6, 7, and 10
Fields 3, 4, 5, 6, and 10
Fields 3, 4, 5, 6, and 10
Fields 3 and 4 except if they have the value
$FOLDERHEADER
Fields 3 through 8
Nobix ElectroPage Administrator’s Reference Guide 98
Appendix C The UNLOAD Program
Cat. # Contains
9 FOLDERA definitions
(Access security)
10 FDISPLY definitions (Rarely occurs)
Non-editable fields
Field 2
Do not modify
Editable fields
Fields 3 through 6
• Data in the fields following the
:TEXT : field are surrounded by double quotes (“) in the
ASCII file. Changes to these fields must be within the double quotes.
• Changes to the ASCII file must meet the criteria stated in this guide for valid data in that specific field.
Backup the current configuration and load the edited ASCII file
1
Logon to the system as MGR.NSD,PUB.
2
Run the UNLOAD program using the output file name.
:UNLOAD.JPAK –LOAD < TEXTCNFG
The backup file name is CFGnnn.JPAK, where nnn is a 3-digit number that is automatically incremented.
The UNLOAD program creates a backup of the current configuration and loads the changes from the ASCII configuration file. The changes take effect immediately, even if JobPak is running.
Warning:
UNLOAD does very little syntax error checking. If you load an ASCII file that has syntax errors, you might cause damage to the configuration files. If this occurs, refer to the
Restore the backup configuration section.
Restore the backup configuration
1
Logon to the system as MGR.NSD,PUB.
2
Enter CHGROUP JPAK .
3
Enter LISTF CFG@,2 .
4
6
Write down the number of the CFGnnn file with the highest number.
5 PURGE
the files FOLDERA, FOLDERF, FOLDERR, FDISPLY, and CONFIG.
At the colon prompt, type UHAUL.PUB
7
8
This runs a script to access the backup configuration.
To the question " DO YOU WANT TO LOAD, UNLOAD OR LIST FILES?
" enter UNLOAD.
To the question " ENTER THE NAME OF YOUR TRUCK ," enter CFGnnn (where nnn is the number from step 4).
This is the file that contains the most recent configuration backup.
The system restores the backup to the configuration files.
Nobix ElectroPage Administrator’s Reference Guide 99
Appendix C The UNLOAD Program
Print a configuration report
1
Logon to the system as MGR.NSD,PUB.
2
Enter the :FILE command specifying the name for the ASCII configuration file.
:FILE TEXTCNFG;SAVE;DISC=50000
3
Run the UNLOAD program using the ASCII configuration file name.
:UNLOAD.JPAK > *TEXTCNFG
4
Enter the :FILE command specifying the name of the output file and device.
:FILE lp;dev=lp
5
Run the POSIX shell and the UNLOAD program specifying the name of the ASCII configuration file and output file command.
:SH.HPBIN.SYS /NSD/EXAMPLE/UNLOAD < TEXTCNFG > *lp
The system sends the report of the configuration to the specified file command.
Example—
UNLOAD.JPAK
@ Wed Nov 18 14:30:37 PST 2005
JobPak configuration
Type
GLOBAL
GLOBAL
GLOBAL
GLOBAL
GLOBAL
GLOBAL
GLOBAL
FileDes.
Job/Ses User Account.Device
Command
CHECKIF
CHECKIF
CHECKEOJ
CHECKEOJ
CONTOK
STARTXEQ
ERROR
Value
NUM
NUM
NUM
NUM
NUM
TEXT
TEXT
1
0
1
0
0
“ ”
“(CIERR”
Nobix ElectroPage Administrator’s Reference Guide 100
