IBM Support

Basic Steps for Creating and Using a Workstation Customization Object

How To


Summary

The steps outlined in this document are intended to be a quick start guide for creating a Workstation Customizing Object (WSCST) then using the object in a printer device or remote output queue configuration.

Objective

Identify the steps needed to retrieve, edit and create a WSCST object, then use the object in a printer device or remote output queue description.
CAUTION:
These instructions are provided AS IS. Any assistance with editing the Workstation Customization Table must be done through a consulting agreement, such as IBM i Customized Services or Lab Services.

Environment

All supported IBM i releases.

Steps

Basic Steps for Creating and Using a Workstation Customization Object (WSCST)

The following are the basic steps for creating a Workstation Customization Object (WSCST), then using the object in a printer device or remote output queue description. Regardless of the particular issues you are attempting to resolve, these steps must always be taken.  The intended audience for this document is users who have familiarity with WSCST objects and configuring printers.

For more, in-depth details for creating a WSCST object:  Instructions for Modifying a Workstation Customizing Object (WSCST)

Tips From Support:
  • Note the WSCST object takes precedence over the MFRTYPMDL.
  • Use the Manufacturer Type and Model (MFRTYPMDL) that is appropriate for your printer.  If the current configuration works well with *HP4, then retrieve the source for MFRTYPMDL *HP4.
  • On the Retrieve WSCST Source (RTVWSCST) Command:
    • ​​​Having the Source Member name the same name as the final WSCST object makes it easier to create the object and to find the member if changes need to be made later.
    • Include the MFRTYPMDL retrieved in the Text Description so you know which source was retrieved.
  • Add comments in the source to identify what changes were made.
  • Create all WSCST objects in the same library and in a library that is in the system or user portion of the library list, such as QGPL.

IMPORTANT:
  • If any changes are made to the WSCST object source code after the CRTWSCST command, it is necessary to issue the CRTWSCST command again and end and restart the writer for the changes to take effect.

Step 1: Retrieve the WSCST source code. 
Tips:
  - Name the Source Member (SRCMBR) the same name as you would like the final WSCST object to be named.
  - Include the MFRTYPMDL retrieved in the Text Description.
Examples:
  • RTVWSCST DEVTYPE(*TRANSFORM) MFRTYPMDL(*HP4) SRCMBR(HP4CPICOR)
    SRCFILE(QGPL/QTXTSRC) TEXT('*HP4 Change CPICOR tags')
  • RTVWSCST DEVTYPE(*TRANSFORM) MFRTYPMDL(*LEXOPTRAT) SRCMBR(PORTRAIT)
    SRCFILE(QGPL/QTXTSRC) TEXT('*LEXOPTRAT Print in Portrait')
  • RTVWSCST DEVTYPE(*TRANSFORM) MFRTYPMDL(*HP4000) SRCMBR(SRCDWR1)
    SRCFILE(QGPL/QTXTSRC) TEXT('*HP4000 Use Source Drawer 1')
  • RTVWSCST DEVTYPE(*TRANSFORM) MFRTYPMDL(*INFOPRINT6500) SRCMBR(PRTDRAFT)
    SRCFILE(QGPL/QTXTSRC) TEXT('*INFOPRINT6500 Print in Draft')

Step 2: Edit the source code by using SEU or PDM:
  • To use SEU:
    • STRSEU SRCFILE(QGPL/QTXTSRC) SRCMBR(SourceMemberName) and press <ENTER>
      **Where SourceMemberName is the SRCMBR from the RTVWSCST command.
  • To use PDM:
    • WRKMBRPDM FILE(QGPL/QTXTSRC) MBR(SourceMemberName) and press <ENTER>
      **Where SourceMemberName is the SRCMBR from the RTVWSCST command.
    • Select option 2=Edit
Step 3:  Make any changes necessary changes to the WSCST object source. Refer to the table in the Additional Information section for a list of documents that contain the most common changes made in WSCST objects.
Tip:
Add comments in the source to identify changes.  To make a comment in the source code, enclose the comment in /* */.  For example,
/* Make your comment here */
:CPICOR
      CPI=15
      ASCIIFNT = 281                   /* ASCII Font ID was 255 changed to 281 */
      FNTWTH   = 72                    /* Font width: 1440 / 20 CPI = 72       */
      FNTATR=    1
      DATA =''X.


Step 4:  After you make the changes to the WSCST source, create the WSCST object:
Tip:
Create all WSCST objects in the same library and in a library that is in the system or user portion of the library list, such as QGPL.
CRTWSCST WSCST(QGPL/SourceMemberName) SRCMBR(*WSCST) SRCFILE(QGPL/QTXTSRC) and press <ENTER>
If you would like WSCST object name to be different than the source member name:
CRTWSCST WSCST(QGPL/WSCSTName) SRCMBR(SourceMemberName) SRCFILE(QGPL/QTXTSRC) and press <ENTER>
**Where SourceMemberName is the SRCMBR from the RTVWSCST command.

Step 5: Add the WSCST to the printer configuration:
To add the WSCST to a *LAN 3812 printer device description
End the writer, vary off the printer device, change the printer device to add the WSCST object, vary on the printer device and, restart the writer:
  • ENDWTR WTR(WriterName) OPTION(*IMMED)
  • VRYCFG CFGOBJ(WriterName) CFGTYPE(*DEV) STATUS(*OFF)
  • CHGDEVPRT DEVD(WriterName) WSCST(LibraryName/WSCSTName)
  • VRYCFG CFGOBJ(WriterName) CFGTYPE(*DEV) STATUS(*ON)
  • STRPRTWTR DEV(WriterName)
To add the WSCST to a remote output queue description
End the writer, change the output queue to add the WSCST object, restart the writer if applicable:
  • ENDWTR WTR(WriterName) OPTION(*IMMED)
  • CHGOUTQ OUTQ(LibraryName/OutputQueueName) WSCST(LibraryName/WSCSTName)
    NOTE:  The writer automatically restarts if the AUTOSTRWTR parameter is set to 1.
  • STRRMTWTR OUTQ(OutputQueueName)
To add the WSCST to an IBM i Access Client Solutions PC5250 printer emulation session
Change the printer session on the PC to add the WSCST object and save the session configuration:
  • In the PC5250 printer session, select Communication > Configure.
  • On the left, select OS/400 Options.
  • In the Host Print Transform box, specify Use HPT as Yes and select the appropriate Printer Manufacturer and Model values.
  • Specify Use Customizing Object as Yes and enter the Customizing Object and Object Library names.
  • Select OK until the printer session restarts.
  • Select File > Save to save the configuration.

Additional Information

Available WSCST documents:
Drawer Redirection for HP PCL5 Compatible Printers

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB08","label":"Cognitive Systems"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]

Document Information

Modified date:
01 October 2020

UID

ibm16337705