CREATE PCL DATA QUEUES
Revised: 2011-02-03
PC Command Link (PCL) is an ActionWare supplied Windows application
which allows an ActionWare program running on the iSeries to cause a command to be executed on the PC.
PCL is a pre-requisite when Microsoft Word Interface (MSWI) is to be used from within ActionWare.
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 Access configuration name on the PC 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 may be created incorrectly, and PCL will
not function.
The solution is to delete them,
and allow them to be created as described in condition #2
above. Note that these data queues do not contain
any permanent data.
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, as described below.
INSTRUCTIONS -- HOW TO
RECREATE DATA QUEUES
These instructions assume:
- The PC operating system is a version of Windows
that supports the version of iSeries Access being used. Examples are Windows XP or Vista Business or Ultimate.
- The iSeries user
profile used is enrolled as an ActionWare user.
- The ActionWare user
profile has Master Control 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 allow users to resume using ActionWare.