Difference between revisions of "Information Systems:System i Operations"
| Line 1: | Line 1: | ||
| − | == Overview == |
||
| − | |||
This computer has had several different names. They may be used interchangeably here, and when looking up information on the internet. The names are AS/400, iSeries, System i, and just plain i. |
This computer has had several different names. They may be used interchangeably here, and when looking up information on the internet. The names are AS/400, iSeries, System i, and just plain i. |
||
| − | + | == Command line === |
|
A ‘command line’ allows you to key in commands or programs. Depending on where you are, it looks something like this – |
A ‘command line’ allows you to key in commands or programs. Depending on where you are, it looks something like this – |
||
| Line 16: | Line 14: | ||
===> ________________________________________________________________________________ |
===> ________________________________________________________________________________ |
||
| − | + | == Library List == |
|
Objects on the i are grouped together in ‘libraries’; which are similar to ‘directories’, or ‘folders’ on a PC, except have only one level. A ‘library list’ is like a ‘path’; it tells the operating system where to look for requested objects. |
Objects on the i are grouped together in ‘libraries’; which are similar to ‘directories’, or ‘folders’ on a PC, except have only one level. A ‘library list’ is like a ‘path’; it tells the operating system where to look for requested objects. |
||
| Line 72: | Line 70: | ||
| − | + | == Menus == |
|
Menus are a way of grouping together related commands or programs. If you know the name, you can go directly there by keying in GO <menu name> on the command line. In ASW the menu name is in the upper right corner in the green screen, and is the last word on the top line of the GUI. This doesn’t work in Extensions, as it uses a custom menu system. |
Menus are a way of grouping together related commands or programs. If you know the name, you can go directly there by keying in GO <menu name> on the command line. In ASW the menu name is in the upper right corner in the green screen, and is the last word on the top line of the GUI. This doesn’t work in Extensions, as it uses a custom menu system. |
||
| − | + | == Commands == |
|
As a rule (of course there are exceptions), commands are made up of three character abbreviations; usually the first letter, then the next two consonants. For example, ‘work with active jobs’ is WRKACTJOB (there aren’t two consonants in JOB after the first letter). An exception is that ‘file’ is typically just ‘F’; as in WRKSPLF (work with spool files), and CPYF (copy file). |
As a rule (of course there are exceptions), commands are made up of three character abbreviations; usually the first letter, then the next two consonants. For example, ‘work with active jobs’ is WRKACTJOB (there aren’t two consonants in JOB after the first letter). An exception is that ‘file’ is typically just ‘F’; as in WRKSPLF (work with spool files), and CPYF (copy file). |
||
| Line 84: | Line 82: | ||
When you find what you think is the correct command, key in that menu option and press enter. The command will not be executed; its prompt screen will be displayed. Move the cursor to the name of the command (first line on the screen), and press F1. This will tell you what the command does, and what parameters are needed. Make sure to use F12 to exit back to the menu – not Enter – if you don’t want to execute the command. |
When you find what you think is the correct command, key in that menu option and press enter. The command will not be executed; its prompt screen will be displayed. Move the cursor to the name of the command (first line on the screen), and press F1. This will tell you what the command does, and what parameters are needed. Make sure to use F12 to exit back to the menu – not Enter – if you don’t want to execute the command. |
||
| − | + | == Print (or Spool) Files == |
|
| − | ==== View by User |
+ | ==== View by User === |
To see a particular user’s print jobs that have not yet been printed, key in the command WRKSPLF <user ID> and press enter. To see your own, just key in WRKSPLF. |
To see a particular user’s print jobs that have not yet been printed, key in the command WRKSPLF <user ID> and press enter. To see your own, just key in WRKSPLF. |
||
Revision as of 11:36, 3 September 2015
This computer has had several different names. They may be used interchangeably here, and when looking up information on the internet. The names are AS/400, iSeries, System i, and just plain i.
Command line =
A ‘command line’ allows you to key in commands or programs. Depending on where you are, it looks something like this –
Selection or command ===> ________________________________________________________________________________ _____________________________________________________________________________________
Or this –
Parameters for options 1, 2, 3 or command ===> ________________________________________________________________________________
Library List
Objects on the i are grouped together in ‘libraries’; which are similar to ‘directories’, or ‘folders’ on a PC, except have only one level. A ‘library list’ is like a ‘path’; it tells the operating system where to look for requested objects.
To see your library list, key in DSPLIBL and press enter.
- Libraries that begin with ‘Q’ are supplied by IBM. (It is a bad idea to start with ‘Q’ when you are building your own objects.)
- ‘QTEMP’ is only accessible by the current job, and will be deleted when it ends. Temporary files can be put here so that they do not have to be implicitly deleted at job end. If work files are put here, each job will have its own data; instead of data for multiple jobs getting mixed together.
- ‘UWDQSYS’ contains objects that we have created, and want available to all users and jobs. As it is first in the library list, we can have our own versions of system objects. For example, program QSTRUP is called by the IPL. We have made changes to it to start up all our applications. It exists in both UWDQSYS and QSYS. Because UWDQSYS comes first in the library list, our customized version is called.
- Each ASW company has its own data libraries – they are changed in the library list when you change companies (green in the following list).
- ASW programs that we change or fix are in XX2480BP (purple), so that they are called instead of the base ASW programs. To test programs without affecting production, we would insert the test library before XX2480BP.
- Base ASW program libraries begin with ‘A’ (original, from Europe) or ‘U’ (modified in the U.S. for North America), then the version number. Notice that subsequent versions are higher in the library list, so that the latest release of a program will be called.
Display Library List
System: BART
5=Display objects in library
ASP
Opt Library Type Device Text
UWDQSYS SYS uniPharm - Custom - System Objects
QSYS SYS System Library
QSYS2 SYS System Library for CPI's
QHLPSYS SYS
QUSRSYS SYS System Library for Users
QTEMP USR
UP1480BFVA USR ASW PRODUCTION DATA FILE LIBRARY
UP1480BS USR ASW system objects for environment UP14
XX1480BP USR ASW rel XX1:480B UWD Extensions (non AS
XX2480BP USR ASW rel XX2:480B object library
UP1480BP USR Aldon/CMS IBS/ASW450/UP1480B (PDN)
U480BP USR Aldon/CMS IBS/ASW450/U480B (PDN)
U480AP USR Aldon/CMS IBS/ASW450/U480A (PDN)
CVT454AP USR ASW rel A:454A Appl CVT object library
A454AP USR ASW rel A:454A object library
A453AP USR ASW rel A:453A object library
A452AP USR ASW rel A:452A object library
A450AP USR ASW rel A:450A object library
QGPL USR General Purpose Library
RCSUTILPRD USR RCS -- Utility Objects and Data -- Prod
UWDASWPRDD USR UWD -- Extensions - VA - Data
UWDASWPRDP USR UWD -- Extensions - Production -- Objec
TLABARCODE USR T.L. Ashford & Associates Barcode400
WEBPRDD USR Web -- Data -- Production
WEBPRDP USR Web -- Programs -- Production
UWDUTILPRD USR UWD -- Extensions -- Common Utilities -
UNIPHARMIT USR UniPHARM IT Tools -- Includes Source
Menus
Menus are a way of grouping together related commands or programs. If you know the name, you can go directly there by keying in GO <menu name> on the command line. In ASW the menu name is in the upper right corner in the green screen, and is the last word on the top line of the GUI. This doesn’t work in Extensions, as it uses a custom menu system.
Commands
As a rule (of course there are exceptions), commands are made up of three character abbreviations; usually the first letter, then the next two consonants. For example, ‘work with active jobs’ is WRKACTJOB (there aren’t two consonants in JOB after the first letter). An exception is that ‘file’ is typically just ‘F’; as in WRKSPLF (work with spool files), and CPYF (copy file).
This makes it possible for you to guess a command. For example, perhaps you want to send someone a message. The code for this is ‘MSG’. All related commands are grouped together on menus, which are named ‘CMD’ plus the code. So to see all message commands, key in GO CMDMSG and press enter.
When you find what you think is the correct command, key in that menu option and press enter. The command will not be executed; its prompt screen will be displayed. Move the cursor to the name of the command (first line on the screen), and press F1. This will tell you what the command does, and what parameters are needed. Make sure to use F12 to exit back to the menu – not Enter – if you don’t want to execute the command.
Print (or Spool) Files
= View by User
To see a particular user’s print jobs that have not yet been printed, key in the command WRKSPLF <user ID> and press enter. To see your own, just key in WRKSPLF.
Work with All Spooled Files
Type options, press Enter.
1=Send 2=Change 3=Hold 4=Delete 5=Display 6=Release 7=Messages
8=Attributes 9=Work with printing status
Device or Total Cur
Opt File User Queue User Data Sts Pages Page Copy
_ FLR202P EODJOB QPRINT FLR202 HLD 2 1
_ FMR065P EODJOB QPRINT FMR065 HLD 1 1
_ FMR050P EODJOB QPRINT FMR050 HLD 1 1
_ GCFP852 EODJOB QPRINT GCFR852 HLD 2 1
_ FKR050P EODJOB QPRINT FKR050 HLD 2 1
_ WMR251P EODJOB PRT01 WMR251 HLD 1 1
_ WMR251P EODJOB PRT01 WMR251 HLD 1 1
_ GCFP852 EODJOB QPRINT GCFR852 HLD 2 1
_ FLR202P EODJOB QPRINT FLR202 HLD 2 1
More...
Parameters for options 1, 2, 3 or command
===> ____________________________________
F3=Exit F10=View 4 F11=View 2 F12=Cancel F22=Printers F24=More keys
Press F11 to see the date and time the spool file was created. Use option 5 to look at the file.
Send to Printer
If you want to print the file but ‘Device or Queue’ is QPRINT or PRT01, use option 2 to change to an output queue that is attached to a physical printer. (The next section of this manual explains what output queues are.)
Change Spooled File Attributes (CHGSPLFA)
Type choices, press Enter.
Spooled file . . . . . . . . . . > QPTAPDSP Name, *SELECT
Job name . . . . . . . . . . . . > DSPTAPE Name, *
User . . . . . . . . . . . . . > EODJOB Name
Number . . . . . . . . . . . . > 298072 000000-999999
Spooled file number . . . . . . > 1 1-999999, *ONLY, *LAST, *ANY
Job system name . . . . . . . . > BART Name, *ONLY, *CURRENT, *ANY
Spooled file created:
Creation date . . . . . . . . > 12182014 Date, *ONLY, *LAST
Creation time . . . . . . . . > 045916 Time, *ONLY, *LAST
Printer . . . . . . . . . . . . *OUTQ Name, *SAME, *OUTQ
Print sequence . . . . . . . . . *SAME *SAME, *NEXT
Form type . . . . . . . . . . . *STD Form type, *SAME, *STD
Copies . . . . . . . . . . . . . 1 1-255, *SAME
Restart printing . . . . . . . . *STRPAGE Number, *SAME, *STRPAGE...
More...
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys
Not on the first screen, where is says ‘*OUTQ’, but on the second page. So press page down.
Change Spooled File Attributes (CHGSPLFA)
Type choices, press Enter.
Additional Parameters
Output queue . . . . . . . . . . > ELAHO Name, *SAME, *DEV
Library . . . . . . . . . . . *LIBL Name, *LIBL, *CURLIB
Bottom
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys
Key in the name of the printer you want (for physical printers, the output queue has the same name as the printer). Clear the library name, and press enter. *LIBL will be inserted, so the library list will be used to find the queue. Press enter again.
Then check the ‘Sts’ column. If it says HLD (held), the entry will have to be released with option 6.
View All Print Files
To see all print jobs that have not yet printed, key in the command WRKOUTQ.
This will show all the output (or printer) queues, how many print jobs there are for each, and the status.
Work with All Output Queues
Type options, press Enter.
2=Change 3=Hold 4=Delete 5=Work with 6=Release 8=Description
9=Work with Writers 14=Clear
Opt Queue Library Files Writer Status
_ OMMQ OMMPRD 0 RLS
_ AIPQUEUE QGPL 0 RLS
_ ASWPICKLST QGPL 1378 RLS
_ ASWPUTAWAY QGPL 0 RLS
_ ASWSOREDI QGPL 916 RLS
_ ASWTSTWHSQ QGPL 0 RLS
_ ASW4DEV QGPL 0 RLS
_ CONVERSION QGPL 0 RLS
_ ELAHO QGPL 5 ELAHO RLS
_ GARBAGE QGPL 0 RLS
_ JIMH QGPL 0 RLS
_ LEX420 QGPL 0 LEX420 RLS
Use option 5 to see what print jobs are in a particular queue.
Work with Output Queue
Queue: ELAHO Library: QGPL Status: RLS/WTR
Type options, press Enter.
1=Send 2=Change 3=Hold 4=Delete 5=Display 6=Release 7=Messages
8=Attributes 9=Work with printing status
Opt File User User Data Sts Pages Copies Form Type Pty
_ RWRP191 FINADMIN RWRR191 HLD 69 1 *STD 5
_ Z3DP101 PAULAE Z3DR101 HLD 1 1 *STD 5
_ Z3DP101 PAULAE Z3DR101 HLD 1 1 *STD 5
_ Z3DP101 PAULAE Z3DR101 HLD 1 1 *STD 5
_ DIR271P JOHNT DIR271 HLD 426 1 *STD 5
Output Queues
‘Work With All Output Queues’ shows all the output queues. This can be many things –
Staging area for reports to be printed. This can be determined by the fact there is a ‘writer’ attached to the queue.
__ DCOFFICE QGPL 0 DCOFFICE RLS __ ELAHO QGPL 4 ELAHO RLS
Holding area for reports that are to be deleted. Some reports are generated, but are never printed. They are cancelled during the end of day process. You can tell which these are because there is no writer attached, and if you use option 5 to see the files, then press F11, all the create dates will be today.
__ ASWPICKLST QGPL 585 RLS __ ASWPUTAWAY QGPL 0 RLS __ ASWSOREDI QGPL 558 RLS
Holding area for reports that aren’t to be printed, but are archived. Some reports are not printed, but are saved in case they are needed in the future. You can tell which these are because there is no writer attached, and if you use option 5 to see the files, then press F11, there will be some old create dates. For example, queues starting with ‘FIN’, in the library ‘FINANCE’, or ‘EDI’ in the library ‘QUSRSYS’.
__ FININVREG FINANCE 2313 RLS __ FININVVAL FINANCE 562 RLS __ FIN201506 FINANCE 11 RLS __ FIN201507 FINANCE 11 RLS
Conduit to send reports to Jet Forms. These are not attached to printers, but instead to the server that runs Jet Forms. You can tell this by using option 2, then F10, and seeing –
Remote system . . . . . . . . . *INTNETADR Character value, *SAME...
Remote printer queue . . . . . . 'JFSRVR' Character value, *SAME...
__ JFHOLD QUSRSYS 3 HLD __ JFPIPE QUSRSYS 538 JFPIPE RLS __ JFSTMTS QUSRSYS 0 JFSTMTS RLS __ JFTEST QUSRSYS 0 JFTEST HLD
Printer definition for Jet Forms. These are printers that are not used directly by the i, but have to be defined so that their names can be used to tell Jet Forms where to print invoices. For more information, see the section on ‘Jet Forms’.
__ L90INV08B QUSRSYS 0 L90INV08B RLS __ NARINV09A QUSRSYS 0 NARINV09A RLS __ OTCINV02A QUSRSYS 0 OTCINV02A RLS
Status (Sts)
RDY (Ready) - The file is available to be written to an output device by a writer.
OPN (Open) - The file has not been completely processed and is not ready to be selected by a writer.
DFR (Deferred) - The file has been deferred from printing.
SND (Sending) - The file is being or has been sent to a remote system. If this status lasts more than a few seconds it indicates a problem (unless it is an unusually large print job).
CLO (Closed) - The file has been completely processed by a program.
HLD (Held) - The file has been held.
SAV (Saved) - The file has been written and then saved. This file will remain saved until it is released or deleted.
WTR (Writer) - This file is currently being produced by the writer on an output device.
PND (Pending) - The file is pending to be printed.
PRT (Printing) - The file has been completely sent to the printer but print complete status has not been sent back.
MSGW (Message Waiting) - This file has a message which needs a reply or an action to be taken.
Problems
If there is a problem with a printer, find it on the list displayed by WRKOUTQ. If the number of files is zero, there is nothing waiting to print, so the problem is elsewhere. If the status is HLD (held), it must be released (option 6). If there is not a writer shown, restart it with option 2, enter, enter.
Use option 5 on the output queue to see the spooled files waiting, and look at the status of the top one. If it is status HLD (held), or SAV (saved), there is nothing waiting to print, so the problem is elsewhere. If it is SND (sending) or WTR (writer), and stays like that, the data is not getting to the printer. If it is MSGW (message waiting) there is a message waiting to be answered, for QSYSOPR. If it is RDY (ready) Use option 9 (work with printing status) and press enter. This may tell you something useful. Try option 2 (change status).