Upgrade Overview



Upgrading From JAM 5



Upgrade Paths


Migration

Utility Conversion

Full Upgrade

Which Path is Best for My Application?


Upgrading the Operating Environment


Update Your Configuration Files

Table 1. Obsolete setup variables.

SMCHEMSGATT

SMCHFORMATTS

SMCHQMSGATT

SMCHSTEXTATT

SMCHUMSGAT

SMDWOPTIONS

SMEROPTIONS

SMFCASE

SMFEXTENSION

SMINDSET

SMMPOPTIONS

SMMPSTRING

SMOKOPTIONS

SMUSEEXT

SMZMOPTIONS

Update Your GUI Resource and Initialization Files

Update Your Data Dictionary into a Repository and LDB

Update Your Main Routines

Update Your Function List

Eliminate the Use of Release 4 Library Functions

Table 2. Obsolete JAM 4 functions and their JAM 7 counterparts.

JAM 4 Function

JAM 7 Function

sm_ch_emsgatt

sm_option

sm_ch_form_atts

sm_option

sm_ch_qmsgatt

sm_option

sm_ch_stextatt

sm_option

sm_choice

sm_input

sm_cl_everyfield

sm_cl_unprot

sm_dw_options

sm_option

sm_er_options

sm_option

sm_fcase

sm_option

sm_fextension

sm_pset

sm_inbusiness

sm_inquire

sm_menu_proc

sm_input

sm_mp_options

sm_option

sm_mp_string

sm_option

sm_ok_options

sm_option

sm_openkeybd

sm_input

sm_plcall

sm_jplcall

sm_sdate

sm_sdtime

sm_stime

sm_sdtime

sm_smsetup

sm_option

sm_unsetup

sm_option

sm_zm_options

sm_option


Converting an Application


The Conversion Toolkit

Table 3. The upgrade utilities.

Utility

Purpose

dd5to6

Converts JAM 5 data dictionaries to JAM 7 repositories and, optionally, Local Data Blocks.

f5to6

Converts JAM 5 screens to JAM 7 format.

m2asc

Converts JAM 5 menu bars to JAM 7 format.

dd2rec

Converts records in a JAM 5 data dictionary to a format for use with sm5strct.c functions (see Table 4 below).

Table 4. Source code for backward compatibility.

Function

Purpose

sm5init.c

Sets JAM 7 library options for JAM 5 compatibility.

sm5ldb.c

Support for JAM 5 LDB scope and initialization functions.

sm5strct.c

Support for JAM 5 bulk load/unload functions.

sm5mbar.c

Support for JAM 5 menu bar API.

f2struct.c

Converts screens to C structures for use with sm5strct.c functions.

When a Feature is Missing...

Screens and Related Topics

Biting the Bullet

Running Your Application for the First Time

The Bottom Line