Technical Note: Common AS/400 Commands

Printed Output:

When viewing any list of things that can be printed, the items at the top of the list are currently printing; the next set of items are waiting to print; and all remaining items have either been placed on hold, or have already been printed and were saved. # # WRKWTR: Shows a list of all current printers, and whether each printer is active, held, stopped, waiting for a message to be answered, etc., allowing you to manage each printer on your system. WRKOUTQ: Shows a list of all current OUTQs. An OUTQ is a place where printed output is grouped together. Use option 5 to view a list of all printed output in any OUTQ. There are two types of OUTQs: A printer OUTQ is associated with a printer, and has the same name as an existing printer. An item in a printer OUTQ will print at the printer with the same name. A stand-alone OUTQ can have any name except the name of an existing printer. An item in a stand-alone OUTQ will not print unless it is moved to a printer OUTQ. (The WRKOUTQ display does not show OUTQ types. When a printer is removed from your system, the OUTQ for that printer remains, automatically becoming a stand-alone OUTQ so that the items grouped in it arent lost. Apparently, the designers of the AS/400 did not think it was important to track which OUTQs currently have printers associated with them and which do not.) WRKOUTQ [printer or stand-alone OUTQ]: Shows a list of all printed output for the printer OUTQ or standalone OUTQ you entered. For example, the command WRKOUTQ P1 shows all printed output for the printer OUTQ associated with printer P1. WRKSPLF: Shows a list of all printed output for yourself. WRKSPLF [user initials]: Shows a list of all printed output for the person whose initials you entered. For example, for a person named Amy Smith whose initials are AS, the command WRKSPLF AS shows all printed output for Amy Smith. WRKSPLF *ALL: Shows a list of all printed output, for everybody. Not often used, as its usually a long list of items, which makes it hard to find exactly the item youre interested in. WRKACTJOB: (See the Jobs section on the next page for a description of the WRKACTJOB command. Although WRKACTJOB is not normally used to view printed output, if you are looking at a WRKACTJOB display, you can use option 8 for any user job on the display to show a list of all printed output associated with that job.) WRKJOB: Shows a menu of status options for your current active job. Selecting option 4 from this job status menu will show a list of all printed output for your current active job. You can also use the DSPJOB command to see the same items, but DSPJOB will not let you control your printed output, whereas WRKJOB will. WRKSBMJOB: Shows a list of all jobs submitted by you to a JOBQ; these jobs may be active, queued, held or completed. Option 8 used with any job on the WRKSBMJOB display will show a list of all printed output associated with that job. (For info on what a JOBQ is, see WRKJOBQ in the Jobs section on the next page.) WRKUSRJOB [user initials]: Shows a list of all jobs for the person whose initials you entered; these jobs may be running, queued, held, or completed. For example, for a person named Amy Smith whose initials are AS, the command WRKUSRJOB AS shows all jobs for Amy Smith. Option 8 used with any job on the WRKUSRJOB display will show a list of all printed output associated with that job. WRKUSRJOB [user initials] *ACTIVE]: Shows a list of all active jobs for the person whose initials you entered; these jobs may be running, queued, or held. For example, for a person named Amy Smith whose initials are AS, the command WRKUSRJOB AS *ACTIVE shows all active jobs for Amy Smith. Option 8 used with any job on the WRKUSRJOB display will show a list of all printed output associated with that job.

# #

# #

Page 1 of 3 4/23/02, 10:47 AM

Technical Note: Common AS/400 Commands

Jobs:
# WRKJOBQ: Shows a list of all JOBQs on the system, and whether they are active, held, stopped, etc, allowing you to manage the JOBQs on your system. What is a JOBQ anyway? Its a queue in which jobs that dont normally need interactive attention to run in the background, so you can do other work while they run. Jobs are queued to JOBQs (usually QBATCH) when they take more than a few minutes to run. Examples of jobs that may be JOBQd are: reports, nightly shutdowns and backups. WRKJOBQ QBATCH: Shows a list of all jobs queued in the QBATCH JOBQ. The QBATCH JOBQ is where most Hippocrates III queued jobs will run. Normally, the QBATCH JOBQ is active and has only active jobs in it, or no jobs, if all queued jobs have completed. If you see a held job in QBATCH, and you were not told by Devington to hold it, call Devington at 212-967-0601 to report the held job. WRKACTJOB: Shows all jobs currently in the system. The most important columns on the WRKACTJOB display are the Subsystem/Job, User and Status columns. There are generally three types of items listed on the WRKACTJOB display: subsystems, system jobs and user jobs. Heres how to tell the difference: Subsystems are lined up with the first S in the Subsystem/Job column, and always have users starting with the letter Q, like: QSYS, QPGMR, and QUSER. Please do not start, stop, hold or cancel any subsystems. System jobs are lined up with the letter b in the Subsystem/Job column, and always have users starting with the letter Q, like: QSYS, QPGMR, and QUSER. Please do not start, stop, hold or cancel any system jobs. User jobs are lined up with the letter b in the Subsystem/Job column. Normally, you will not start, stop, hold or cancel any user jobs. However, once in a while, an unusual condition may occur, like a lock or an error message. When something appears not to be working normally on your system, use the WRKACTJOB command to look for user jobs with a LCKW or MSGW status. If you see such items, call Devington immediately for assistance in how to deal with these. You can also use option 8 to see a list of the printed output for any user job. WRKJOB: Shows the status of your current job. The WRKJOB command is often used to see and control printed output from your current job. Use option 4 to see a list of all printed output for your current job. WRKSBMJOB: Shows all jobs you have submitted to a JOBQ that are active, still queued up, held, or have completed and have printed output somewhere in the system. For any job you see listed in the WRKSBMJOB display, use option 8 to see the associated printed output. WRKUSRJOB [user initials]: Shows a list of all jobs for the person whose initials you entered; these jobs may be running, queued, held, or completed. For example, for a person named Amy Smith whose initials are AS, the command WRKUSRJOB AS shows all jobs for Amy Smith. Option 8 used with any job on the WRKUSRJOB display will show a list of all printed output associated with that job. WRKUSRJOB [user initials] *ACTIVE]: Shows a list of all active jobs for the person whose initials you entered; these jobs may be running, queued, or held. For example, for a person named Amy Smith whose initials are AS, the command WRKUSRJOB AS *ACTIVE shows all active jobs for Amy Smith. Option 8 used with any job on the WRKUSRJOB display will show a list of all printed output associated with that job.

# #

Page 2 of 3 4/23/02, 10:47 AM

Technical Note: Common AS/400 Commands Messages

# # DSPMSG: Shows all messages for you, and all messages for your current session. DSPMSG QSYSOPR: Shows all system-level messages. Messages needing a reply are very important. Normally, youll only see these for managing your printers. If you see any other messages needing a reply, contact Devington immediately for assistance in handling them.

Communications
# WRKCFGSTS *LIN: Shows a list of all communications lines on your system, and their status. Devington technicians may be ask you to use this command from time to time, if there are problems with your systems communications. WRKCFGSTS *CTL: Shows a list of all communications and device controllers on your system, and their status. Devington technicians may be ask you to use this command from time to time, if there are problems with your systems communications or devices. WRKCFGSTS *DEV: Shows a list of all devices, like workstations, printers, and virtual workstations, on your system, and their status. Devington technicians may be ask you to use this command from time to time, if there are problems with your systems devices.

Miscellaneous
# # WRKSYSSTS: Shows the status of memory and hard drive on your system. Only needed if your system is extremely slow, and then only rarely, as WRKACTJOB tells much more about whats happening on your system. PWRDWNSYS: Allows you to force your system down and bring it back up again. Used only if your system has a severe problem. Always call Devington (212-967-0601) or IBM before using this command, unless you have been trained as an AS/400 system operator.

Page 3 of 3 4/23/02, 10:47 AM