8.1.2 Create PC Definitions

To create new PC definitions, use the Add/Create function key on the Work with PC Definitions screen.

This will cause the Create PC Definition screen to be displayed:

 

DC@P642103                Create PC Definition                           PC Name  . . . . . . . . . . . . . .   ____________                    PC Description . . . . . . . . . . .   ____________________________      Data Queue In  . . . . . . . . . . .   ____________                    Data Queue Out . . . . . . . . . . .   ____________                    Monitor Program                                                        Job Description  . . . . . . . . .   *LIBL/QBATCH                      Job Queue  . . . . . . . . . . . .   *LIBL/QINTER                     Output Queue . . . . . . . . . . .   *LIBL/QPRINT                    Translation                                                            Table In . . . . . . . . . . . . .   QSYS/ANSEBC1140                  Table Out  . . . . . . . . . . . .   QSYS/QASCII                     Submitted Jobs                                                         Job Description  . . . . . . . . .   *LIBL/QBATCH                      Job Queue  . . . . . . . . . . . .   *LIBL/QBATCH                      Output Queue . . . . . . . . . . .   *LIBL/QPRINT           More..     F1=Help  F3=Exit  F14=Messages

 

The details on the Create PC Definition screen should be entered or modified according to these guidelines:

PC Name

Must be a valid IBM i name. This is the node name that you gave your PC when Visual LANSA was installed.

PC Description

A brief description for the PC.

Data Queue In & Out

The name you specify for "Data Queue In" or "Data Queue Out" is used to form the name of an IBM i library. The name is formed by appending the letters _DQL to the name you specify. The resulting name is then truncated to form at most a 10 character IBM i library name.

Thus, if you specify TESTIN, the resulting library name would be TESTIN_DQL. If you specify name TESTWORK then the resulting name would be TESTWORK_D. If you specify name TESTWORKIN then the resulting library name would be TESTWORKIN.

The portion of any queue library name that you specify:

• Must be different to any other input or output queue name already specified for any other workstation (including the one that you are currently defining).

• Must be a valid IBM i object name.

The library name (and the required objects within it) will be automatically created and initialized when the workstation starts a Host Monitor session or when you next do a LANSA database REORG operation.

Generally the libraries do not need to be backed up.

If the queues within the library become unusable you can rectify the problem by:

• Running a LANSA database REORG

or

• Shutting down the Host Monitor of the workstation involved, clearing or deleting the libraries and then restarting the Host Monitor.

Either of these solutions will of course lose any information currently held in the queues within the libraries.

Monitor Program

The Job Description, Job Queue and Output Queue entered here will be the ones used for the LANSA Host Monitor Program to run. They must be entered in IBM i format.

Translation Table In

This is the table used by LANSA to translate data received from the PC (ASCII) to the format used on the IBM i (EBCDIC).

If you are creating multilingual applications please read the Translation Table for all Users regarding this entry.

Translation Table Out

This is the table used by LANSA to translate data from the format used on the IBM i (EBCDIC) to the format used on the PC (ASCII).

If you are creating multilingual applications please read the Translation Table for all Users regarding this entry.

Submitted Jobs

The Job Description, Job Queue and Output Queue entered here will be the ones used by the LANSA Host Monitor Program to submit jobs. They must be entered in IBM i format.

After entering the details, 'page down' should be pressed to display the second part of the screen.

                                                            

DC@P642103                Create PC Definition                           Allowable Partitions . . . . . . . .                         ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___    ___                F1=Help  F3=Exit  F14=Messages

Allowable Partitions

This screen allows the specification of partitions allowed for the PC to sign on to. Enter up to 50 unique identifiers to allow access to these partitions. If the PC tries to sign on to a partition that is not specified here, the LANSA Host Monitor job on the IBM i will terminate.

After pressing Enter, the data will be stored on file. At the same time, the inbound and outbound libraries of data queues are created. Also, a data area with the same name as the inbound data queue library is created. These three sets of objects are required for running the LANSA Host Monitor.