Print Page as PDF
ICPTMOD Update CSV APIs ICR (6129)

ICPTMOD Update CSV APIs    ICR (6129)

Name Value
NUMBER 6129
IA # 6129
DATE CREATED 2014/11/17
CUSTODIAL PACKAGE CPT/HCPCS CODES
USAGE Supported
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE ICPTMOD
NAME ICPTMOD Update CSV APIs
GENERAL DESCRIPTION
$$NM, $$LD, $$CM and $$MODC were added as part of the
Code Set Versioning APIs in patch ICPT*6.0*46.

STATUS Active
KEYWORDS
  • NM
  • LD
  • $$NM
  • $$LD
  • CM
  • $$CM
  • MODC
  • $$MODC
DURATION Till Otherwise Agreed
ID ICPTMOD
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
$$NM(CODE,CDT,.ARY,LEN)
This API returns the CPT/HCPCS Modifier Name (short
description) formatted in string lengths specified.

VARIABLES TYPE VARIABLES DESCRIPTION
CODE Input
This is a CPT Modifier code.

CDT Input
This is the date that will be used to return the
modifier name that was appropriate for the date.

.ARY Both
This is a local array passed by reference that will
contain the modifier name in string lengths specified.  This array is first
killed by the API then populated with the modifier name.

LEN Input
This is the desired length of the text to be returned
(10-78, default 78).

$$NM Output
This is the number of lines in the output array or -1
^ Error Message

$$LD(CODE,CDT,.ARY,LEN)
This API returns the CPT/HCPCS Modifier Description
(long description) formatted in string lengths specified.

VARIABLES TYPE VARIABLES DESCRIPTION
CODE Input
This is a CPT or HCPCS Modifier Code.

CDT Input
This is the date that will be used to return the
description that was appropriate for the date.

.ARY Both
This is a local array passed by reference that will
contain the description in string lengths specified.  This array is first
killed by the API then populated with the modifier description.

LEN Input
This is the desired length of the text to be returned
(15-245, default 78).

$$LD Output
This is the number of lines in the output array or -1
^ Error Message

$$CM(Y,CPT,CDT,SRC)
This API provides logic for a DIC("S") type screen
for a lookup in the CPT Modifier file #81.3, where the CPT/HCPCS code is known
and the screen filters out CPT Modifiers that cannot be used with the code on
the specified date.

Example:

S DIC("S")="I $$CM^ICPTMOD(CPT,+Y,CDT,SRC)>0"

VARIABLES TYPE VARIABLES DESCRIPTION
Y Input
This is a CPT/HCPCS Modifier Internal Entry Number
(IEN) from the CPT Modifier file #81.3

CPT Input
This is a CPT/HCPCS Code or Internal Entry Number
(IEN) from the CPT file #81.

CDT Input
This is the date that will be used to determine if
the CPT Modifier can be used with a code.

SRC Input
This is the CPT level I, II or III as follows:

If 0 or Null, use Level I and II modifiers
If >0, use Level I, II, and III modifiers

$$CM Output
This is a Boolean value:

1  Modifier Y can be used with CPT code X
0  Modifier Y cannot be used with CPT code X

$$MODC(MOD,CPT,CDT)
This API returns the active CPT range of a Modifier
that includes the CPT/HCPCS code.

VARIABLES TYPE VARIABLES DESCRIPTION
MOD Input
This is a Modifier Code in the external format
(Required)

CPT Input
This is a CPT/HCPCS Code in the external format
(Required)

CDT Input
This is the date that will be used to determine if
the CPT Modifier can be used with a code.

$$MODC Output
This is a 9 piece "^" delimited string as follows:

1   Modifier IEN
2   Modifier                     (#.01)
3   Active                       (#60, .01)
4   Modifier Name                (#61, 1)
5   CPT Range IEN                (#10)
6   CPT Begin Range Code         (#10, .01)
7   CPT End Range Code           (#10, .02)
8   CPT Range Activation Date    (#10, .03)
9   CPT Range Inactivation Date  (#10, .04)

or

0 when a qualifying range is not found

or

-1 ^ error message on error

DATE ACTIVATED 2015/02/23