CREATE PCL DATA QUEUES
Revised: 2007-04-24
PCL creates and uses two data queues in
the QGPL library. They are named xxxxxxxxDN and xxxxxxxxUP, where
xxxxxxxx represents the System Name of the iSeries. The
iSeries System Name appears in the top right corner of most
system menus, and it can also be displayed with the DSPNETA
command.
These two data queues are normally
created just once, and they can serve any number of users. They
are automatically created under either of these two conditions.
- 1. When PCL is started on a
PC, it connects to the default iSeries defined and
named in iSeries Access. (Note- PCL requires that
the iSeries name used in the CAE configuration must be
the actual iSeries System Name.) PCL connects to
the iSeries and attempts to open the two data queues
in QGPL. If they do not exist, PCL creates them.
- 2. When a green screen user
enters ActionWare with Master Control option #57 set
to 1 = use PCL, the ActionWare program checks for the
existence of the two data queues in QGPL. If they do not
exist, ActionWare creates them.
A problem with the creation of the
data queues has been discovered when they are created as a result
of condition #1 above. They are created incorrectly, and PCL will
not function.
The solution is to delete them,
and cause them to be created as described in condition #2
above.
Supplemental Note: Power Failure
It has been observed that if the iSeries goes
down hard as the result of a power failure, one or both of these data queues
may be reported as being "damaged". The solution to this
situation is to delete them and recreate them, exactly as described below.
INSTRUCTIONS -- HOW TO
RECREATE DATA QUEUES
These instructions assume:
- The PC operating system is one of Windows
98/2E/ME/NT/2000/XP.
- The iSeries user
profile used is
enrolled as an ActionWare user.
- The ActionWare user
profile has Master Controls option #57 set to 1 = use PCL.
- The iSeries user
profile used has
sufficient authority to perform the steps described.
Instructions:
- Ask all ActionWare users
to exit ActionWare.
- End PCL on all PCs by
double clicking on the PCL icon on the task bar and
selecting Exit.
- Sign onto an iSeries
green screen emulation session.
- Determine the name of the
iSeries by entering command DSPNETA and recording the
System Name.
- Enter command WRKOBJ QGPL/*ALL
*DTAQ
- Locate the two PCL data
queues in the list. The names will start with the system
name, and end with DN and UP. There may or may not be
other data queues in the list, be very careful not to
interfere with them, they are not related to ActionWare.
- Delete the two PCL data
queues using option 4.
- Enter ActionWare by
entering command AW4LM and selecting option 1. If
necessary, press Enter until you arrive at the first
contact record.
- Exit ActionWare. To
verify the data queues were created, enter command WRKOBJ
QGPL/*ALL *DTAQ again.
- You should see the same
two data queues. This time they were created by the
ActionWare green screen program, not by the PC.
- Finished. Under normal circumstances
it will not be necessary to follow these instructions again.
- You can now use PCL
normally.