IBM Support

Finding the Source Code for a Modified Workstation Customizing Object (WSCST)

Troubleshooting


Problem

This document provides instructions for finding the source code for a modified Workstation Customizing Object (WSCST).

Resolving The Problem

This document provides instructions for finding the source code for a modified Workstation Customizing Object (WSCST) or *WSCST object. To find the source physical file member containing the source code for a modified Workstation Customizing Object (WSCST), do the following:

1.Use the Display Object Description (DSPOBJD) command to display the object description for a specific *WSCST object; for example:   

DSPOBJD OBJ(QGPL/HP4) OBJTYPE(*WSCST)   

or use the DSPOBJD command to work with several *WSCST object by specifying *ALL or a generic name for the Object (OBJ) parameter; for example:   

DSPOBJD OBJ(QGPL/*ALL) OBJTYPE(*WSCST)   

DSPOBJD OBJ(QGPL/HP*) OBJTYPE(*WSCST)
2.Select Option 8 (display service attributes) next to the *WSCST object and press the Enter key.
3.Look at the Source file, Library and Member fields that are shown on the first screen.
4.Use the Work with Members Using PDM (WRKMBRPDM) command to work with the source member used to create the *WSCST object; for example:   

WRKMBRPDM FILE(QGPL/QTXTSRC) MBR(HP4)   

or use the WRKMBRPDM command to work with all of the members in the source physical file, for example:   

WRKMBRPDM FILE(QGPL/QTXTSRC) MBR(*ALL)   

and then take Option 2 (Edit) on the source member that needs to be edited.


Notes:

  • If these steps are used to find the WSCST source for a system-supplied WSCST table, you will find that the Source file, Library, and Member fields are blank. To work with the source code for a system-supplied WSCST table, retrieve the WSCST source code using the Retrieve WSCST source (RTVWSCST) command. For more information on this, refer to the following Rochester Support Center knowledgebase document:   
    N1010140: Instructions for Modifying a Workstation Customizing Object (WSCST)
  • If the original WSCST source member specified by the Display Object Description (DSPOBJD) command has been deleted from the IBM i system, you will need to restore the source physical file and member from backups. This is necessary because the Create WSCST (CRTWSCST) command does not store the WSCST source in the *WSCST object that is created.
  • Alternately, a workaround is available and takes advantage of the ability of the Retrieve WSCST source (RTVWSCST) command to retrieve the WSCST source code for system-supplied *WSCST objects.


Work-around to retrieve the source for a custom WSCST

To retrieve the source for a custom WSCST you have, you can use the built in ability to retrieve the source for a prebuilt WSCST like *HP4. This is not guaranteed to work but has worked for customers in the past.

  1. Rename the existing *HP4 WSCST (QWPHPLSR4 in QSYS) to a backup name:  
    RNMOBJ OBJ(QSYS/QWPHPLSR4) OBJTYPE(*WSCST) NEWOBJ(QWPHPLSR4B)
  2. Rename your WSCST to be QWPHPLSR4 and put it in lib QSYS. 
  3. Retrieve the source for what the system will now think is *HP4: 
    RTVWSCST DEVTYPE(*TRANSFORM) MFRTYPMDL(*HP4) SRCMBR(CUSTOMSRC) SRCFILE(QGPL/QTXTSRC) 
  4. Then clean up your workaround by renaming your WSCST back to it's original name/location, and rename *HP4 WSCST to it's original name: 
    RNMOBJ OBJ(QSYS/QWPHPLSR4B) OBJTYPE(*WSCST) NEWOBJ(QWPHPLSR4) 

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]

Historical Number

15433348

Document Information

Modified date:
16 September 2025

UID

nas8N1019634